Developer CD Series 1994 December: Reference Library

home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 …ember: Reference Library / Dev.CD Dec 94.toast / Technical Documentation / QuickTime Documentation / How to write a Data Handler < prev next >
MacBinary | 1994-10-20 | 55.8 KB | [ONLN/HLX2]
open in:
MacOS 8.1 extracted |
Win98 extracted |
DOS extracted
browse contents |
view JSON data |
view as text

This file was processed as: MacBinary (archive/macBinary).
Confidence	Program	Detection	Match Type	Support
`10%`	dexvert	MacBinary `(archive/macBinary)`	fallback	Supported
`100%`	file	MacBinary II, inited, Mon Apr 25 12:48:24 1994, modified Thu Oct 20 15:09:55 1994, creator 'HLX2', type 'ONLN', 55047 bytes "How to write a Data Handler" , at 0xd787 1672 bytes resource	default (weak)
`99%`	file	data	default
`100%`	TrID	MacBinary 2	default (weak)
`100%`	siegfried	fmt/1762 MacBinary (II)	default
`100%`	lsar	MacBinary	default
id metadata
key	value
macFileType	`[ONLN]`
macFileCreator	`[HLX2]`
hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 1b 48 6f 77 20 74 6f | 20 77 72 69 74 65 20 61 |..How to| write a|
|00000010| 20 44 61 74 61 20 48 61 | 6e 64 6c 65 72 00 00 00 | Data Ha|ndler...|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 4f 4e 4c 4e 48 4c 58 | 32 01 00 00 00 00 00 00 |.ONLNHLX|2.......|
|00000050| 00 00 00 00 00 d7 07 00 | 00 06 88 a9 e1 a4 d8 aa |........|........|
|00000060| cc 71 03 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.q......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 3f 37 00 00 |........|....?7..|
|00000080| 48 6f 77 20 74 6f 20 57 | 72 69 74 65 20 61 20 44 |How to W|rite a D|
|00000090| 61 74 61 20 48 61 6e 64 | 6c 65 72 0d 51 75 69 63 |ata Hand|ler.Quic|
|000000a0| 6b 54 69 6d 65 20 76 65 | 72 73 69 6f 6e 3a 20 32 |kTime ve|rsion: 2|
|000000b0| 2e 30 0d 49 6e 74 72 6f | 64 75 63 74 69 6f 6e 0d |.0.Intro|duction.|
|000000c0| 47 6f 6f 64 20 6c 75 63 | 6b 2e 0d 44 61 74 61 20 |Good luc|k..Data |
|000000d0| 48 61 6e 64 6c 65 72 20 | 53 65 6c 65 63 74 69 6f |Handler |Selectio|
|000000e0| 6e 0d 49 6e 20 74 68 65 | 20 70 61 73 74 2c 20 51 |n.In the| past, Q|
|000000f0| 75 69 63 6b 54 69 6d 65 | 20 63 68 6f 73 65 20 77 |uickTime| chose w|
|00000100| 68 69 63 68 20 64 61 74 | 61 20 68 61 6e 64 6c 65 |hich dat|a handle|
|00000110| 72 20 74 6f 20 75 73 65 | 20 66 6f 72 20 61 20 67 |r to use| for a g|
|00000120| 69 76 65 6e 20 4d 6f 76 | 69 65 2f 6d 65 64 69 61 |iven Mov|ie/media|
|00000130| 20 6f 6e 6c 79 20 62 61 | 73 65 64 20 6f 6e 20 74 | only ba|sed on t|
|00000140| 68 65 20 74 79 70 65 20 | 6f 66 20 74 68 65 20 64 |he type |of the d|
|00000150| 61 74 61 20 72 65 66 65 | 72 65 6e 63 65 20 6f 66 |ata refe|rence of|
|00000160| 20 74 68 65 20 6d 65 64 | 69 61 2e 20 4d 65 64 69 | the med|ia. Medi|
|00000170| 61 20 77 68 69 63 68 20 | 75 73 65 64 20 66 69 6c |a which |used fil|
|00000180| 65 73 20 77 65 20 61 73 | 73 69 67 6e 65 64 20 61 |es we as|signed a|
|00000190| 6e 20 d4 61 6c 69 73 d5 | 20 64 61 74 61 20 72 65 |n .alis.| data re|
|000001a0| 66 65 72 65 6e 63 65 2c | 20 77 68 69 63 68 20 63 |ference,| which c|
|000001b0| 61 75 73 65 64 20 74 68 | 65 20 73 74 61 6e 64 61 |aused th|e standa|
|000001c0| 72 64 20 41 70 70 6c 65 | 20 44 61 74 61 20 48 61 |rd Apple| Data Ha|
|000001d0| 6e 64 6c 65 72 20 74 6f | 20 62 65 20 75 73 65 64 |ndler to| be used|
|000001e0| 20 74 6f 20 72 65 61 64 | 20 74 68 65 20 66 69 6c | to read| the fil|
|000001f0| 65 2e 20 49 66 20 61 6e | 6f 74 68 65 72 20 64 61 |e. If an|other da|
|00000200| 74 61 20 68 61 6e 64 6c | 65 72 20 77 61 73 20 74 |ta handl|er was t|
|00000210| 6f 20 62 65 20 75 73 65 | 64 2c 20 65 69 74 68 65 |o be use|d, eithe|
|00000220| 72 20 74 68 65 20 6d 6f | 76 69 65 20 68 61 64 20 |r the mo|vie had |
|00000230| 74 6f 20 62 65 20 63 68 | 61 6e 67 65 64 20 74 6f |to be ch|anged to|
|00000240| 20 63 6f 6e 74 61 69 6e | 20 61 20 64 61 74 61 20 | contain| a data |
|00000250| 72 65 66 65 72 65 6e 63 | 65 20 6f 66 20 61 20 64 |referenc|e of a d|
|00000260| 69 66 66 65 72 65 6e 74 | 20 74 79 70 65 20 6f 72 |ifferent| type or|
|00000270| 20 74 68 65 20 6f 74 68 | 65 72 20 64 61 74 61 20 | the oth|er data |
|00000280| 68 61 6e 64 6c 65 72 20 | 68 61 64 20 74 6f 20 6f |handler |had to o|
|00000290| 76 65 72 72 69 64 65 20 | 74 68 65 20 65 78 69 73 |verride |the exis|
|000002a0| 74 69 6e 67 20 41 70 70 | 6c 65 20 d4 61 6c 69 73 |ting App|le .alis|
|000002b0| d5 20 64 61 74 61 20 68 | 61 6e 64 6c 65 72 2c 20 |. data h|andler, |
|000002c0| 62 75 74 20 6f 6e 6c 79 | 20 66 6f 72 20 74 68 6f |but only| for tho|
|000002d0| 73 65 20 76 6f 6c 75 6d | 65 73 20 77 68 69 63 68 |se volum|es which|
|000002e0| 20 69 74 20 77 61 73 20 | 63 6f 6e 63 65 72 6e 65 | it was |concerne|
|000002f0| 64 20 77 69 74 68 2e 20 | 54 68 69 73 20 73 69 74 |d with. |This sit|
|00000300| 75 61 74 69 6f 6e 20 77 | 61 73 20 66 61 72 20 66 |uation w|as far f|
|00000310| 72 6f 6d 20 69 64 65 61 | 6c 2c 20 61 6e 64 20 70 |rom idea|l, and p|
|00000320| 61 72 74 69 63 75 6c 61 | 72 6c 79 20 6d 65 73 73 |articula|rly mess|
|00000330| 79 20 69 6e 20 61 6e 20 | 65 6e 76 69 72 6f 6e 6d |y in an |environm|
|00000340| 65 6e 74 20 77 68 65 72 | 65 20 6d 75 6c 74 69 70 |ent wher|e multip|
|00000350| 6c 65 20 64 61 74 61 20 | 68 61 6e 64 6c 65 72 73 |le data |handlers|
|00000360| 20 77 65 72 65 20 69 6e | 76 6f 6c 76 65 64 2e 0d | were in|volved..|
|00000370| 51 75 69 63 6b 54 69 6d | 65 20 6e 6f 77 20 61 6c |QuickTim|e now al|
|00000380| 6c 6f 77 73 20 61 20 64 | 61 74 61 20 68 61 6e 64 |lows a d|ata hand|
|00000390| 6c 65 72 20 74 6f 20 62 | 65 20 73 70 65 63 69 66 |ler to b|e specif|
|000003a0| 69 63 61 6c 6c 79 20 61 | 73 73 6f 63 69 61 74 65 |ically a|ssociate|
|000003b0| 64 20 77 69 74 68 20 61 | 20 70 61 72 74 69 63 75 |d with a| particu|
|000003c0| 6c 61 72 20 76 6f 6c 75 | 6d 65 20 28 65 76 65 6e |lar volu|me (even|
|000003d0| 20 61 20 70 61 72 74 69 | 63 75 6c 61 72 20 6b 69 | a parti|cular ki|
|000003e0| 6e 64 20 6f 66 20 66 69 | 6c 65 29 2e 20 54 68 69 |nd of fi|le). Thi|
|000003f0| 73 20 61 6c 6c 6f 77 73 | 20 6d 6f 76 69 65 73 20 |s allows| movies |
|00000400| 74 6f 20 62 65 20 6d 6f | 76 65 64 20 62 65 74 77 |to be mo|ved betw|
|00000410| 65 65 6e 20 76 61 72 69 | 6f 75 73 20 74 79 70 65 |een vari|ous type|
|00000420| 73 20 6f 66 20 64 65 76 | 69 63 65 73 20 77 69 74 |s of dev|ices wit|
|00000430| 68 6f 75 74 20 68 61 76 | 69 6e 67 20 74 6f 20 62 |hout hav|ing to b|
|00000440| 65 20 61 6c 74 65 72 65 | 64 20 69 6e 20 61 6e 79 |e altere|d in any|
|00000450| 77 61 79 2c 20 70 72 6f | 76 69 64 65 64 20 74 68 |way, pro|vided th|
|00000460| 61 74 20 74 68 65 20 64 | 65 76 69 63 65 73 20 61 |at the d|evices a|
|00000470| 6c 6c 20 61 70 70 65 61 | 72 20 61 73 20 61 20 76 |ll appea|r as a v|
|00000480| 6f 6c 75 6d 65 2e 20 46 | 75 72 74 68 65 72 6d 6f |olume. F|urthermo|
|00000490| 72 65 2c 20 69 74 20 69 | 73 20 6e 6f 74 20 6e 65 |re, it i|s not ne|
|000004a0| 63 65 73 73 61 72 79 20 | 74 6f 20 6f 76 65 72 72 |cessary |to overr|
|000004b0| 69 64 65 20 74 68 65 20 | 65 78 69 73 74 69 6e 67 |ide the |existing|
|000004c0| 20 d4 61 6c 69 73 d5 20 | 64 61 74 61 20 68 61 6e | .alis. |data han|
|000004d0| 64 6c 65 72 20 74 6f 20 | 61 63 68 69 65 76 65 20 |dler to |achieve |
|000004e0| 74 68 69 73 2e 0d 54 6f | 20 61 63 68 69 65 76 65 |this..To| achieve|
|000004f0| 20 74 68 69 73 2c 20 74 | 68 65 20 64 61 74 61 20 | this, t|he data |
|00000500| 68 61 6e 64 6c 65 72 20 | 6d 75 73 74 20 69 6d 70 |handler |must imp|
|00000510| 6c 65 6d 65 6e 74 20 74 | 77 6f 20 61 64 64 69 74 |lement t|wo addit|
|00000520| 69 6f 6e 61 6c 20 63 61 | 6c 6c 73 2e 20 54 68 65 |ional ca|lls. The|
|00000530| 20 66 69 72 73 74 20 63 | 61 6c 6c 20 6d 75 73 74 | first c|all must|
|00000540| 20 62 65 20 69 6d 70 6c | 65 6d 65 6e 74 65 64 20 | be impl|emented |
|00000550| 62 79 20 61 6c 6c 20 64 | 61 74 61 20 68 61 6e 64 |by all d|ata hand|
|00000560| 6c 65 72 73 2c 20 6e 6f | 74 20 6a 75 73 74 20 d4 |lers, no|t just .|
|00000570| 61 6c 69 73 d5 20 64 61 | 74 61 20 68 61 6e 64 6c |alis. da|ta handl|
|00000580| 65 72 73 2e 0d 70 61 73 | 63 61 6c 20 43 6f 6d 70 |ers..pas|cal Comp|
|00000590| 6f 6e 65 6e 74 52 65 73 | 75 6c 74 20 44 61 74 61 |onentRes|ult Data|
|000005a0| 48 43 61 6e 55 73 65 44 | 61 74 61 52 65 66 20 28 |HCanUseD|ataRef (|
|000005b0| 44 61 74 61 48 61 6e 64 | 6c 65 72 20 64 68 2c 20 |DataHand|ler dh, |
|000005c0| 48 61 6e 64 6c 65 20 64 | 61 74 61 52 65 66 2c 20 |Handle d|ataRef, |
|000005d0| 6c 6f 6e 67 20 2a 75 73 | 65 46 6c 61 67 73 29 0d |long *us|eFlags).|
|000005e0| 65 6e 75 6d 20 7b 0d 09 | 6b 44 61 74 61 48 43 61 |enum {..|kDataHCa|
|000005f0| 6e 52 65 61 64 20 3d 20 | 31 4c 3c 3c 30 2c 0d 09 |nRead = |1L<<0,..|
|00000600| 6b 44 61 74 61 48 53 70 | 65 63 69 61 6c 52 65 61 |kDataHSp|ecialRea|
|00000610| 64 20 3d 20 31 4c 3c 3c | 31 2c 0d 09 6b 44 61 74 |d = 1L<<|1,..kDat|
|00000620| 61 48 53 70 65 63 69 61 | 6c 52 65 61 64 46 69 6c |aHSpecia|lReadFil|
|00000630| 65 20 3d 20 31 4c 3c 3c | 32 2c 0d 09 6b 44 61 74 |e = 1L<<|2,..kDat|
|00000640| 61 48 43 61 6e 57 72 69 | 74 65 20 3d 20 31 4c 3c |aHCanWri|te = 1L<|
|00000650| 3c 33 2c 0d 09 6b 44 61 | 74 61 48 53 70 65 63 69 |<3,..kDa|taHSpeci|
|00000660| 61 6c 57 72 69 74 65 20 | 3d 20 31 3c 3c 34 2c 0d |alWrite |= 1<<4,.|
|00000670| 09 6b 44 61 74 61 48 53 | 70 65 63 69 61 6c 57 72 |.kDataHS|pecialWr|
|00000680| 69 74 65 46 69 6c 65 20 | 3d 20 31 3c 3c 35 2c 0d |iteFile |= 1<<5,.|
|00000690| 09 6b 44 61 74 61 48 43 | 61 6e 53 74 72 65 61 6d |.kDataHC|anStream|
|000006a0| 69 6e 67 57 72 69 74 65 | 20 3d 20 31 3c 3c 36 2c |ingWrite| = 1<<6,|
|000006b0| 0d 09 6b 44 61 74 61 48 | 4d 75 73 74 43 68 65 63 |..kDataH|MustChec|
|000006c0| 6b 44 61 74 61 52 65 66 | 20 3d 20 31 3c 3c 37 0d |kDataRef| = 1<<7.|
|000006d0| 7d 3b 0d 44 61 74 61 48 | 43 61 6e 55 73 65 44 61 |};.DataH|CanUseDa|
|000006e0| 74 61 52 65 66 20 20 69 | 73 20 70 61 73 73 65 64 |taRef  i|s passed|
|000006f0| 20 61 20 64 61 74 61 20 | 72 65 66 65 72 65 6e 63 | a data |referenc|
|00000700| 65 20 61 6e 64 20 72 65 | 74 75 72 6e 73 20 66 6c |e and re|turns fl|
|00000710| 61 67 73 20 69 6e 64 69 | 63 61 74 69 6e 67 20 69 |ags indi|cating i|
|00000720| 74 73 20 61 62 69 6c 69 | 74 79 20 74 6f 20 61 63 |ts abili|ty to ac|
|00000730| 63 65 73 73 20 74 68 65 | 20 64 61 74 61 20 72 65 |cess the| data re|
|00000740| 66 65 72 65 6e 63 65 2e | 20 49 66 20 74 68 65 20 |ference.| If the |
|00000750| 64 61 74 61 20 72 65 66 | 65 72 65 6e 63 65 20 63 |data ref|erence c|
|00000760| 61 6e 6e 6f 74 20 62 65 | 20 72 65 61 64 20 74 6f |annot be| read to|
|00000770| 20 6f 72 20 77 72 69 74 | 74 65 6e 20 66 72 6f 6d | or writ|ten from|
|00000780| 2c 20 74 68 65 20 72 65 | 74 75 72 6e 65 64 20 66 |, the re|turned f|
|00000790| 6c 61 67 73 20 73 68 6f | 75 6c 64 20 62 65 20 73 |lags sho|uld be s|
|000007a0| 65 74 20 74 6f 20 30 2e | 0d 6b 44 61 74 61 48 43 |et to 0.|.kDataHC|
|000007b0| 61 6e 52 65 61 64 09 63 | 61 6e 20 72 65 61 64 20 |anRead.c|an read |
|000007c0| 66 72 6f 6d 20 74 68 69 | 73 20 64 61 74 61 20 72 |from thi|s data r|
|000007d0| 65 66 65 72 65 6e 63 65 | 09 0d 6b 44 61 74 61 48 |eference|..kDataH|
|000007e0| 53 70 65 63 69 61 6c 52 | 65 61 64 09 63 61 6e 20 |SpecialR|ead.can |
|000007f0| 72 65 61 64 20 66 72 6f | 6d 20 74 68 69 73 20 64 |read fro|m this d|
|00000800| 61 74 61 20 72 65 66 65 | 72 65 6e 63 65 20 75 73 |ata refe|rence us|
|00000810| 69 6e 67 20 61 20 73 70 | 65 63 69 61 6c 69 7a 65 |ing a sp|ecialize|
|00000820| 64 20 6d 65 74 68 6f 64 | 20 28 66 6f 72 20 65 78 |d method| (for ex|
|00000830| 61 6d 70 6c 65 2c 20 69 | 66 20 61 6e 20 48 46 53 |ample, i|f an HFS|
|00000840| 20 76 6f 6c 75 6d 65 2c | 20 74 68 69 73 20 77 6f | volume,| this wo|
|00000850| 75 6c 64 20 6d 65 61 6e | 20 72 65 61 64 69 6e 67 |uld mean| reading|
|00000860| 20 6f 74 68 65 72 20 74 | 68 61 6e 20 75 73 69 6e | other t|han usin|
|00000870| 67 20 46 69 6c 65 20 53 | 79 73 74 65 6d 20 63 61 |g File S|ystem ca|
|00000880| 6c 6c 73 29 09 0d 6b 44 | 61 74 61 48 53 70 65 63 |lls)..kD|ataHSpec|
|00000890| 69 61 6c 52 65 61 64 46 | 69 6c 65 09 63 61 6e 20 |ialReadF|ile.can |
|000008a0| 72 65 61 64 20 66 72 6f | 6d 20 74 68 69 73 20 64 |read fro|m this d|
|000008b0| 61 74 61 20 72 65 66 65 | 72 65 6e 63 65 20 75 73 |ata refe|rence us|
|000008c0| 69 6e 67 20 61 20 73 70 | 65 63 69 61 6c 69 7a 65 |ing a sp|ecialize|
|000008d0| 64 20 6d 65 74 68 6f 64 | 20 77 68 69 63 68 20 69 |d method| which i|
|000008e0| 73 20 73 70 65 63 69 66 | 69 63 20 74 6f 20 74 68 |s specif|ic to th|
|000008f0| 65 20 74 79 70 65 20 6f | 66 20 66 69 6c 65 20 62 |e type o|f file b|
|00000900| 65 69 6e 67 20 72 65 61 | 64 20 28 66 6f 72 20 65 |eing rea|d (for e|
|00000910| 78 61 6d 70 6c 65 20 61 | 20 48 79 70 65 72 43 61 |xample a| HyperCa|
|00000920| 72 64 20 73 74 61 63 6b | 20 6d 69 67 68 74 20 62 |rd stack| might b|
|00000930| 65 20 6d 6f 72 65 20 65 | 66 66 69 63 69 65 6e 74 |e more e|fficient|
|00000940| 6c 79 20 72 65 61 64 20 | 62 79 20 61 20 6d 65 74 |ly read |by a met|
|00000950| 68 6f 64 20 6f 74 68 65 | 72 20 74 68 61 6e 20 74 |hod othe|r than t|
|00000960| 68 61 74 20 75 73 65 64 | 20 62 79 20 74 68 65 20 |hat used| by the |
|00000970| 73 74 61 6e 64 61 72 64 | 20 44 61 74 61 20 48 61 |standard| Data Ha|
|00000980| 6e 64 6c 65 72 29 09 0d | 6b 44 61 74 61 48 43 61 |ndler)..|kDataHCa|
|00000990| 6e 57 72 69 74 65 09 63 | 61 6e 20 77 72 69 74 65 |nWrite.c|an write|
|000009a0| 20 74 6f 20 74 68 69 73 | 20 64 61 74 61 20 72 65 | to this| data re|
|000009b0| 66 65 72 65 6e 63 65 09 | 0d 6b 44 61 74 61 48 53 |ference.|.kDataHS|
|000009c0| 70 65 63 69 61 6c 57 72 | 69 74 65 09 63 61 6e 20 |pecialWr|ite.can |
|000009d0| 77 72 69 74 65 20 74 6f | 20 74 68 69 73 20 64 61 |write to| this da|
|000009e0| 74 61 20 72 65 66 65 72 | 65 6e 63 65 20 75 73 69 |ta refer|ence usi|
|000009f0| 6e 67 20 61 20 73 70 65 | 63 69 61 6c 69 7a 65 64 |ng a spe|cialized|
|00000a00| 20 6d 65 74 68 6f 64 20 | 28 66 6f 72 20 65 78 61 | method |(for exa|
|00000a10| 6d 70 6c 65 2c 20 61 20 | 73 70 65 63 69 61 6c 69 |mple, a |speciali|
|00000a20| 7a 65 64 20 6e 65 74 77 | 6f 72 6b 20 70 72 6f 74 |zed netw|ork prot|
|00000a30| 6f 63 6f 6c 29 09 0d 6b | 44 61 74 61 48 53 70 65 |ocol)..k|DataHSpe|
|00000a40| 63 69 61 6c 57 72 69 74 | 65 46 69 6c 65 20 09 28 |cialWrit|eFile .(|
|00000a50| 74 68 69 73 20 68 61 73 | 20 6e 6f 20 6d 65 61 6e |this has| no mean|
|00000a60| 69 6e 67 20 72 69 67 68 | 74 20 6e 6f 77 29 09 0d |ing righ|t now)..|
|00000a70| 6b 44 61 74 61 48 43 61 | 6e 53 74 72 65 61 6d 69 |kDataHCa|nStreami|
|00000a80| 6e 67 57 72 69 74 65 09 | 73 75 70 70 6f 72 74 73 |ngWrite.|supports|
|00000a90| 20 74 68 65 20 41 50 49 | 20 63 6f 6d 6d 61 6e 64 | the API| command|
|00000aa0| 73 20 66 6f 72 20 6d 6f | 76 69 65 20 63 61 70 74 |s for mo|vie capt|
|00000ab0| 75 72 65 09 0d 6b 44 61 | 74 61 48 4d 75 73 74 43 |ure..kDa|taHMustC|
|00000ac0| 68 65 63 6b 44 61 74 61 | 52 65 66 20 09 28 74 68 |heckData|Ref .(th|
|00000ad0| 69 73 20 66 6c 61 67 20 | 69 73 20 6f 6e 6c 79 20 |is flag |is only |
|00000ae0| 75 73 65 64 20 66 6f 72 | 20 74 68 65 20 44 61 74 |used for| the Dat|
|00000af0| 61 48 47 65 74 56 6f 6c | 75 6d 65 49 6e 66 6f 20 |aHGetVol|umeInfo |
|00000b00| 63 61 6c 6c 29 09 0d 0d | 54 68 65 20 73 74 61 6e |call)...|The stan|
|00000b10| 64 61 72 64 20 41 70 70 | 6c 65 20 d4 61 6c 69 73 |dard App|le .alis|
|00000b20| d5 20 44 61 74 61 20 48 | 61 6e 64 6c 65 72 20 72 |. Data H|andler r|
|00000b30| 65 74 75 72 6e 73 20 6b | 44 61 74 61 48 43 61 6e |eturns k|DataHCan|
|00000b40| 52 65 61 64 20 61 6e 64 | 20 6b 44 61 74 61 48 43 |Read and| kDataHC|
|00000b50| 61 6e 57 72 69 74 65 20 | 66 6f 72 20 61 6e 79 20 |anWrite |for any |
|00000b60| 64 61 74 61 20 72 65 66 | 65 72 65 6e 63 65 20 70 |data ref|erence p|
|00000b70| 61 73 73 65 64 20 74 6f | 20 69 74 2e 20 54 68 69 |assed to| it. Thi|
|00000b80| 73 20 69 6e 64 69 63 61 | 74 65 73 20 74 68 61 74 |s indica|tes that|
|00000b90| 20 69 74 20 69 73 20 61 | 62 6c 65 20 74 6f 20 73 | it is a|ble to s|
|00000ba0| 75 70 70 6f 72 74 20 72 | 65 61 64 69 6e 67 20 61 |upport r|eading a|
|00000bb0| 6e 64 20 77 72 69 74 69 | 6e 67 20 74 6f 20 61 6e |nd writi|ng to an|
|00000bc0| 79 20 76 6f 6c 75 6d 65 | 2e 20 41 20 64 61 74 61 |y volume|. A data|
|00000bd0| 20 68 61 6e 64 6c 65 72 | 20 77 68 69 63 68 20 70 | handler| which p|
|00000be0| 72 6f 76 69 64 65 64 20 | 73 70 65 63 69 61 6c 69 |rovided |speciali|
|00000bf0| 7a 65 64 20 61 63 63 65 | 73 73 20 74 6f 20 61 20 |zed acce|ss to a |
|00000c00| 70 61 72 74 69 63 75 6c | 61 72 20 76 6f 6c 75 6d |particul|ar volum|
|00000c10| 65 20 77 6f 75 6c 64 20 | 72 65 74 75 72 6e 20 30 |e would |return 0|
|00000c20| 20 66 6f 72 20 61 6e 79 | 20 64 61 74 61 20 72 65 | for any| data re|
|00000c30| 66 65 72 65 6e 63 65 20 | 72 65 66 65 72 65 6e 63 |ference |referenc|
|00000c40| 69 6e 67 20 61 20 76 6f | 6c 75 6d 65 20 77 68 69 |ing a vo|lume whi|
|00000c50| 63 68 20 64 69 64 20 6e | 6f 74 20 73 75 70 70 6f |ch did n|ot suppo|
|00000c60| 72 74 73 20 69 74 73 20 | 6e 65 74 77 6f 72 6b 69 |rts its |networki|
|00000c70| 6e 67 20 70 72 6f 74 6f | 63 6f 6c 2e 20 49 74 20 |ng proto|col. It |
|00000c80| 77 6f 75 6c 64 20 72 65 | 74 75 72 6e 20 6b 44 61 |would re|turn kDa|
|00000c90| 74 61 48 43 61 6e 52 65 | 61 64 20 61 6e 64 20 6b |taHCanRe|ad and k|
|00000ca0| 44 61 74 61 48 53 70 65 | 63 69 61 6c 52 65 61 64 |DataHSpe|cialRead|
|00000cb0| 20 66 6f 72 20 61 6e 79 | 20 76 6f 6c 75 6d 65 20 | for any| volume |
|00000cc0| 77 68 69 63 68 20 64 69 | 64 20 73 75 70 70 6f 72 |which di|d suppor|
|00000cd0| 74 20 69 74 73 20 6e 65 | 74 77 6f 72 6b 69 6e 67 |t its ne|tworking|
|00000ce0| 20 70 72 6f 74 6f 63 6f | 6c 20 28 69 66 20 69 74 | protoco|l (if it|
|00000cf0| 20 73 75 70 70 6f 72 74 | 65 64 20 77 72 69 74 69 | support|ed writi|
|00000d00| 6e 67 20 61 73 20 77 65 | 6c 6c 2c 20 69 74 20 77 |ng as we|ll, it w|
|00000d10| 6f 75 6c 64 20 73 65 74 | 20 6b 44 61 74 61 48 43 |ould set| kDataHC|
|00000d20| 61 6e 57 72 69 74 65 20 | 61 6e 64 20 6b 44 61 74 |anWrite |and kDat|
|00000d30| 61 48 53 70 65 63 69 61 | 6c 57 72 69 74 65 29 2e |aHSpecia|lWrite).|
|00000d40| 0d 54 68 65 20 41 70 70 | 6c 65 20 d4 61 6c 69 73 |.The App|le .alis|
|00000d50| d5 20 44 61 74 61 20 48 | 61 6e 64 6c 65 72 20 77 |. Data H|andler w|
|00000d60| 68 69 63 68 20 73 75 70 | 70 6f 72 74 73 20 6c 69 |hich sup|ports li|
|00000d70| 76 65 20 6d 6f 76 69 65 | 20 63 61 70 74 75 72 65 |ve movie| capture|
|00000d80| 2c 20 73 65 74 73 20 74 | 68 65 20 6b 44 61 74 61 |, sets t|he kData|
|00000d90| 48 43 61 6e 53 74 72 65 | 61 6d 69 6e 67 57 72 69 |HCanStre|amingWri|
|00000da0| 74 65 20 66 6c 61 67 20 | 74 6f 20 69 6e 64 69 63 |te flag |to indic|
|00000db0| 61 74 65 20 74 68 61 74 | 20 69 74 20 73 75 70 70 |ate that| it supp|
|00000dc0| 6f 72 74 73 20 74 68 65 | 20 41 50 49 20 6e 65 63 |orts the| API nec|
|00000dd0| 65 73 73 61 72 79 20 66 | 6f 72 20 6d 6f 76 69 65 |essary f|or movie|
|00000de0| 20 63 61 70 74 75 72 65 | 2e 20 49 66 20 61 20 64 | capture|. If a d|
|00000df0| 61 74 61 20 68 61 6e 64 | 6c 65 72 20 73 75 70 70 |ata hand|ler supp|
|00000e00| 6f 72 74 65 64 20 74 68 | 69 73 20 41 50 49 20 61 |orted th|is API a|
|00000e10| 6e 64 20 70 72 6f 76 69 | 64 65 64 20 73 70 65 63 |nd provi|ded spec|
|00000e20| 69 61 6c 69 7a 65 64 20 | 61 63 63 65 73 73 20 74 |ialized |access t|
|00000e30| 6f 20 61 20 70 61 72 74 | 69 63 75 6c 61 72 20 76 |o a part|icular v|
|00000e40| 6f 6c 75 6d 65 2c 20 69 | 74 20 77 6f 75 6c 64 20 |olume, i|t would |
|00000e50| 73 65 74 20 6b 44 61 74 | 61 48 43 61 6e 53 74 72 |set kDat|aHCanStr|
|00000e60| 65 61 6d 69 6e 67 57 72 | 69 74 65 20 61 6e 64 20 |eamingWr|ite and |
|00000e70| 74 68 65 20 6b 44 61 74 | 61 48 53 70 65 63 69 61 |the kDat|aHSpecia|
|00000e80| 6c 57 72 69 74 65 20 66 | 6c 61 67 20 61 73 20 77 |lWrite f|lag as w|
|00000e90| 65 6c 6c 2e 0d 55 73 69 | 6e 67 20 74 68 65 20 44 |ell..Usi|ng the D|
|00000ea0| 61 74 61 48 43 61 6e 55 | 73 65 44 61 74 61 52 65 |ataHCanU|seDataRe|
|00000eb0| 66 20 63 61 6c 6c 2c 20 | 69 74 20 69 73 20 70 6f |f call, |it is po|
|00000ec0| 73 73 69 62 6c 65 20 74 | 6f 20 61 6c 77 61 79 73 |ssible t|o always|
|00000ed0| 20 63 68 6f 6f 73 65 20 | 61 6e 20 61 70 70 72 6f | choose |an appro|
|00000ee0| 70 72 69 61 74 65 20 44 | 61 74 61 20 48 61 6e 64 |priate D|ata Hand|
|00000ef0| 6c 65 72 20 66 6f 72 20 | 61 20 67 69 76 65 6e 20 |ler for |a given |
|00000f00| 64 61 74 61 20 72 65 66 | 65 72 65 6e 63 65 2e 20 |data ref|erence. |
|00000f10| 55 6e 66 6f 72 74 75 6e | 61 74 65 6c 79 2c 20 74 |Unfortun|ately, t|
|00000f20| 68 69 73 20 72 65 71 75 | 69 72 65 73 20 74 68 61 |his requ|ires tha|
|00000f30| 74 20 65 76 65 72 79 20 | 64 61 74 61 20 68 61 6e |t every |data han|
|00000f40| 64 6c 65 72 20 6f 66 20 | 61 20 67 69 76 65 6e 20 |dler of |a given |
|00000f50| 74 79 70 65 20 62 79 20 | 71 75 65 72 69 65 64 20 |type by |queried |
|00000f60| 66 6f 72 20 65 76 65 72 | 79 20 64 61 74 61 20 72 |for ever|y data r|
|00000f70| 65 66 65 72 65 6e 63 65 | 2c 20 74 6f 20 6c 6f 63 |eference|, to loc|
|00000f80| 61 74 65 20 74 68 65 20 | 62 65 73 74 20 63 68 6f |ate the |best cho|
|00000f90| 69 63 65 2e 20 54 68 69 | 73 20 63 61 6e 20 62 65 |ice. Thi|s can be|
|00000fa0| 20 73 6c 6f 77 2e 20 54 | 6f 20 73 70 65 65 64 20 | slow. T|o speed |
|00000fb0| 74 68 69 73 20 70 72 6f | 63 65 73 73 2c 20 74 68 |this pro|cess, th|
|00000fc0| 65 20 4d 6f 76 69 65 20 | 54 6f 6f 6c 62 6f 78 20 |e Movie |Toolbox |
|00000fd0| 6d 61 69 6e 74 61 69 6e | 73 20 61 6e 20 69 6e 74 |maintain|s an int|
|00000fe0| 65 72 6e 61 6c 20 6c 69 | 73 74 20 6f 66 20 d4 61 |ernal li|st of .a|
|00000ff0| 6c 69 73 d5 20 64 61 74 | 61 20 68 61 6e 64 6c 65 |lis. dat|a handle|
|00001000| 72 73 20 61 6e 64 20 74 | 68 65 69 72 20 61 73 73 |rs and t|heir ass|
|00001010| 6f 63 69 61 74 65 64 20 | 76 6f 6c 75 6d 65 73 2e |ociated |volumes.|
|00001020| 20 42 79 20 75 73 69 6e | 67 20 74 68 69 73 20 6c | By usin|g this l|
|00001030| 69 73 74 2c 20 74 68 65 | 20 4d 6f 76 69 65 20 54 |ist, the| Movie T|
|00001040| 6f 6f 6c 62 6f 78 20 63 | 61 6e 20 75 73 75 61 6c |oolbox c|an usual|
|00001050| 6c 79 20 71 75 69 63 6b | 6c 79 20 6c 6f 63 61 74 |ly quick|ly locat|
|00001060| 65 20 61 6e 20 61 70 70 | 72 6f 70 72 69 61 74 65 |e an app|ropriate|
|00001070| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 66 6f | data ha|ndler fo|
|00001080| 72 20 61 6e 20 d4 61 6c | 69 73 d5 20 64 61 74 61 |r an .al|is. data|
|00001090| 20 72 65 66 65 72 65 6e | 63 65 2e 0d 54 68 65 20 | referen|ce..The |
|000010a0| 4d 6f 76 69 65 20 54 6f | 6f 6c 62 6f 78 20 6d 61 |Movie To|olbox ma|
|000010b0| 6b 65 73 20 74 68 65 20 | 44 61 74 61 48 47 65 74 |kes the |DataHGet|
|000010c0| 56 6f 6c 75 6d 65 4c 69 | 73 74 20 63 61 6c 6c 20 |VolumeLi|st call |
|000010d0| 74 6f 20 72 65 74 72 69 | 65 76 65 20 61 20 6c 69 |to retri|eve a li|
|000010e0| 73 74 20 6f 66 20 61 6c | 6c 20 76 6f 6c 75 6d 65 |st of al|l volume|
|000010f0| 73 20 74 68 61 74 20 61 | 20 67 69 76 65 6e 20 64 |s that a| given d|
|00001100| 61 74 61 20 68 61 6e 64 | 6c 65 72 20 63 61 6e 20 |ata hand|ler can |
|00001110| 61 63 63 65 73 73 2c 20 | 61 6c 6f 6e 67 20 77 69 |access, |along wi|
|00001120| 74 68 20 74 68 65 20 64 | 61 74 61 20 68 61 6e 64 |th the d|ata hand|
|00001130| 6c 65 72 d5 73 20 63 61 | 70 61 62 69 6c 69 65 73 |ler.s ca|pabilies|
|00001140| 20 66 6f 72 20 65 61 63 | 68 20 76 6f 6c 75 6d 65 | for eac|h volume|
|00001150| 2e 0d 70 61 73 63 61 6c | 20 43 6f 6d 70 6f 6e 65 |..pascal| Compone|
|00001160| 6e 74 52 65 73 75 6c 74 | 20 44 61 74 61 48 47 65 |ntResult| DataHGe|
|00001170| 74 56 6f 6c 75 6d 65 4c | 69 73 74 20 28 44 61 74 |tVolumeL|ist (Dat|
|00001180| 61 48 61 6e 64 6c 65 72 | 20 64 68 2c 20 44 61 74 |aHandler| dh, Dat|
|00001190| 61 48 56 6f 6c 75 6d 65 | 4c 69 73 74 20 2a 76 6f |aHVolume|List *vo|
|000011a0| 6c 75 6d 65 4c 69 73 74 | 29 0d 74 79 70 65 64 65 |lumeList|).typede|
|000011b0| 66 20 73 74 72 75 63 74 | 20 44 61 74 61 48 56 6f |f struct| DataHVo|
|000011c0| 6c 75 6d 65 4c 69 73 74 | 52 65 63 6f 72 64 20 7b |lumeList|Record {|
|000011d0| 0d 73 68 6f 72 74 09 76 | 52 65 66 4e 75 6d 3b 0d |.short.v|RefNum;.|
|000011e0| 6c 6f 6e 67 09 66 6c 61 | 67 73 3b 0d 7d 20 44 61 |long.fla|gs;.} Da|
|000011f0| 74 61 48 56 6f 6c 75 6d | 65 4c 69 73 74 52 65 63 |taHVolum|eListRec|
|00001200| 6f 72 64 2c 20 2a 44 61 | 74 61 48 56 6f 6c 75 6d |ord, *Da|taHVolum|
|00001210| 65 4c 69 73 74 50 74 72 | 2c 20 2a 2a 44 61 74 61 |eListPtr|, **Data|
|00001220| 48 56 6f 6c 75 6d 65 4c | 69 73 74 3b 0d 54 68 65 |HVolumeL|ist;.The|
|00001230| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 73 68 | data ha|ndler sh|
|00001240| 6f 75 6c 64 20 72 65 74 | 75 72 6e 20 61 20 44 61 |ould ret|urn a Da|
|00001250| 74 61 48 56 6f 6c 75 6d | 65 4c 69 73 74 20 68 61 |taHVolum|eList ha|
|00001260| 6e 64 6c 65 20 66 69 6c | 6c 65 64 20 69 6e 20 77 |ndle fil|led in w|
|00001270| 69 74 68 20 61 6e 20 65 | 6e 74 72 79 20 66 6f 72 |ith an e|ntry for|
|00001280| 20 65 61 63 68 20 76 6f | 6c 75 6d 65 20 74 68 61 | each vo|lume tha|
|00001290| 74 20 74 68 65 20 44 61 | 74 61 20 48 61 6e 64 6c |t the Da|ta Handl|
|000012a0| 65 72 20 63 61 6e 20 61 | 63 63 65 73 73 2e 20 54 |er can a|ccess. T|
|000012b0| 68 65 20 66 6c 61 67 73 | 20 61 72 65 20 74 68 65 |he flags| are the|
|000012c0| 20 73 61 6d 65 20 61 73 | 20 74 68 6f 73 65 20 64 | same as| those d|
|000012d0| 65 73 63 72 69 62 65 64 | 20 66 6f 72 20 44 61 74 |escribed| for Dat|
|000012e0| 61 48 43 61 6e 55 73 65 | 44 61 74 61 52 65 66 2e |aHCanUse|DataRef.|
|000012f0| 20 48 6f 77 65 76 65 72 | 2c 20 6f 6e 65 20 61 64 | However|, one ad|
|00001300| 64 69 74 69 6f 6e 61 6c | 20 66 6c 61 67 2c 20 6b |ditional| flag, k|
|00001310| 44 61 74 61 48 4d 75 73 | 74 43 68 65 63 6b 44 61 |DataHMus|tCheckDa|
|00001320| 74 61 52 65 66 20 2c 20 | 6d 61 79 20 62 65 20 75 |taRef , |may be u|
|00001330| 73 65 64 20 68 65 72 65 | 2e 20 53 65 74 74 69 6e |sed here|. Settin|
|00001340| 67 20 74 68 65 20 6b 44 | 61 74 61 48 4d 75 73 74 |g the kD|ataHMust|
|00001350| 43 68 65 63 6b 44 61 74 | 61 52 65 66 20 20 66 6c |CheckDat|aRef  fl|
|00001360| 61 67 20 69 6e 64 69 63 | 61 74 65 73 20 74 68 61 |ag indic|ates tha|
|00001370| 74 20 74 68 65 20 64 61 | 74 61 20 68 61 6e 64 6c |t the da|ta handl|
|00001380| 65 72 20 63 61 6e d5 74 | 20 64 65 74 65 72 6d 69 |er can.t| determi|
|00001390| 6e 65 20 74 68 65 20 61 | 70 70 72 6f 70 72 69 61 |ne the a|ppropria|
|000013a0| 74 65 20 66 6c 61 67 73 | 20 75 6e 74 69 6c 20 69 |te flags| until i|
|000013b0| 74 20 69 73 20 67 69 76 | 65 6e 20 61 6e 20 61 63 |t is giv|en an ac|
|000013c0| 74 75 61 6c 20 44 61 74 | 61 20 52 65 66 65 72 65 |tual Dat|a Refere|
|000013d0| 6e 63 65 2e 20 49 6e 20 | 74 68 69 73 20 63 61 73 |nce. In |this cas|
|000013e0| 65 2c 20 77 68 65 6e 20 | 61 20 64 61 74 61 20 68 |e, when |a data h|
|000013f0| 61 6e 64 6c 65 72 20 66 | 6f 72 20 61 6e 20 d4 61 |andler f|or an .a|
|00001400| 6c 69 73 d5 20 64 61 74 | 61 20 72 65 66 65 6e 63 |lis. dat|a refenc|
|00001410| 65 20 69 73 20 62 65 69 | 6e 67 20 6c 6f 6f 6b 65 |e is bei|ng looke|
|00001420| 64 20 66 6f 72 2c 20 74 | 68 65 20 44 61 74 61 48 |d for, t|he DataH|
|00001430| 43 61 6e 55 73 65 44 61 | 74 61 52 65 66 20 63 61 |CanUseDa|taRef ca|
|00001440| 6c 6c 20 77 69 6c 6c 20 | 61 6c 77 61 79 73 20 62 |ll will |always b|
|00001450| 65 20 6d 61 64 65 20 74 | 6f 20 74 68 65 20 64 61 |e made t|o the da|
|00001460| 74 61 20 68 61 6e 64 6c | 65 72 20 62 65 66 6f 72 |ta handl|er befor|
|00001470| 65 20 69 74 20 69 73 20 | 73 65 6c 65 63 74 65 64 |e it is |selected|
|00001480| 2c 20 74 6f 20 67 65 74 | 20 74 68 65 20 63 75 72 |, to get| the cur|
|00001490| 72 65 6e 74 20 66 6c 61 | 67 73 2e 20 54 68 69 73 |rent fla|gs. This|
|000014a0| 20 6d 61 6b 65 73 20 74 | 68 65 20 73 65 6c 65 63 | makes t|he selec|
|000014b0| 74 69 6f 6e 20 70 72 6f | 63 65 73 73 20 73 6c 6f |tion pro|cess slo|
|000014c0| 77 65 72 2e 20 48 6f 77 | 65 76 65 72 2c 20 69 6e |wer. How|ever, in|
|000014d0| 20 73 6f 6d 65 20 63 61 | 73 65 73 20 69 74 20 69 | some ca|ses it i|
|000014e0| 73 20 6e 65 63 65 73 73 | 61 72 79 2e 0d 54 68 65 |s necess|ary..The|
|000014f0| 20 4d 6f 76 69 65 20 54 | 6f 6f 6c 62 6f 78 20 74 | Movie T|oolbox t|
|00001500| 72 61 63 6b 73 20 74 68 | 65 20 6d 6f 75 6e 74 69 |racks th|e mounti|
|00001510| 6e 67 20 61 6e 64 20 75 | 6e 6d 6f 75 6e 74 69 6e |ng and u|nmountin|
|00001520| 67 20 6f 66 20 76 6f 6c | 75 6d 65 73 2c 20 73 6f |g of vol|umes, so|
|00001530| 20 74 68 61 74 20 69 74 | 73 20 76 6f 6c 75 6d 65 | that it|s volume|
|00001540| 20 63 61 63 68 65 20 63 | 61 6e 20 62 65 20 6b 65 | cache c|an be ke|
|00001550| 70 74 20 63 75 72 72 65 | 6e 74 2e 0d 20 0d 70 61 |pt curre|nt.. .pa|
|00001560| 73 63 61 6c 20 43 6f 6d | 70 6f 6e 65 6e 74 52 65 |scal Com|ponentRe|
|00001570| 73 75 6c 74 20 44 61 74 | 61 48 47 65 74 44 65 76 |sult Dat|aHGetDev|
|00001580| 69 63 65 49 6e 64 65 78 | 20 28 44 61 74 61 48 61 |iceIndex| (DataHa|
|00001590| 6e 64 6c 65 72 20 64 68 | 2c 20 6c 6f 6e 67 20 2a |ndler dh|, long *|
|000015a0| 64 65 76 69 63 65 49 6e | 64 65 78 29 0d 44 61 74 |deviceIn|dex).Dat|
|000015b0| 61 48 47 65 74 44 65 76 | 69 63 65 49 6e 64 65 78 |aHGetDev|iceIndex|
|000015c0| 20 61 6c 6c 6f 77 73 20 | 74 68 65 20 64 61 74 61 | allows |the data|
|000015d0| 20 68 61 6e 64 6c 65 72 | 20 74 6f 20 72 65 74 75 | handler| to retu|
|000015e0| 72 6e 20 61 20 6c 6f 6e | 67 20 77 68 69 63 68 20 |rn a lon|g which |
|000015f0| 75 6e 69 71 75 65 6c 79 | 20 69 64 65 6e 74 69 66 |uniquely| identif|
|00001600| 69 65 73 20 74 68 65 20 | 64 65 76 69 63 65 20 6f |ies the |device o|
|00001610| 6e 20 77 68 69 63 68 20 | 64 61 74 61 20 63 75 72 |n which |data cur|
|00001620| 72 65 6e 74 20 64 61 74 | 61 20 72 65 66 65 72 65 |rent dat|a refere|
|00001630| 6e 63 65 20 72 65 73 69 | 64 65 73 2e 20 49 6e 20 |nce resi|des. In |
|00001640| 74 68 65 20 63 61 73 65 | 20 6f 66 20 74 68 65 20 |the case| of the |
|00001650| 41 6c 69 61 73 20 64 61 | 74 61 20 68 61 6e 64 6c |Alias da|ta handl|
|00001660| 65 72 2c 20 74 68 69 73 | 20 69 73 20 74 68 65 20 |er, this| is the |
|00001670| 76 6f 6c 75 6d 65 20 72 | 65 66 65 72 65 6e 63 65 |volume r|eference|
|00001680| 20 6e 75 6d 62 65 72 2e | 20 54 68 69 73 20 6e 75 | number.| This nu|
|00001690| 6d 62 65 72 20 69 73 20 | 6d 61 79 20 62 65 20 75 |mber is |may be u|
|000016a0| 73 65 64 20 62 79 20 73 | 6f 6d 65 20 63 6c 69 65 |sed by s|ome clie|
|000016b0| 6e 74 73 20 74 6f 20 64 | 65 74 65 72 6d 69 6e 65 |nts to d|etermine|
|000016c0| 20 69 66 20 74 77 6f 20 | 64 69 66 66 65 72 65 6e | if two |differen|
|000016d0| 74 20 64 61 74 61 20 72 | 65 66 65 72 65 6e 63 65 |t data r|eference|
|000016e0| 73 20 72 65 73 69 64 65 | 20 6f 6e 20 74 68 65 20 |s reside| on the |
|000016f0| 73 61 6d 65 20 70 68 79 | 73 69 63 61 6c 20 64 65 |same phy|sical de|
|00001700| 76 69 63 65 2e 20 54 68 | 69 73 20 69 73 20 75 73 |vice. Th|is is us|
|00001710| 65 66 75 6c 20 69 6e 20 | 63 61 73 65 73 20 77 68 |eful in |cases wh|
|00001720| 65 72 65 20 73 74 6f 72 | 61 67 65 20 6d 61 79 20 |ere stor|age may |
|00001730| 62 65 20 70 72 65 61 6c | 6c 6f 63 61 74 65 64 2e |be preal|located.|
|00001740| 0d 4d 61 6e 61 67 69 6e | 67 20 44 61 74 61 20 52 |.Managin|g Data R|
|00001750| 65 66 65 72 65 6e 63 65 | 73 0d 70 61 73 63 61 6c |eference|s.pascal|
|00001760| 20 43 6f 6d 70 6f 6e 65 | 6e 74 52 65 73 75 6c 74 | Compone|ntResult|
|00001770| 20 44 61 74 61 48 53 65 | 74 44 61 74 61 52 65 66 | DataHSe|tDataRef|
|00001780| 20 28 44 61 74 61 48 61 | 6e 64 6c 65 72 20 64 68 | (DataHa|ndler dh|
|00001790| 2c 20 48 61 6e 64 6c 65 | 20 64 61 74 61 52 65 66 |, Handle| dataRef|
|000017a0| 20 29 0d 54 68 65 20 64 | 61 74 61 20 68 61 6e 64 | ).The d|ata hand|
|000017b0| 6c 65 72 20 69 6e 73 74 | 61 6e 63 65 20 69 73 20 |ler inst|ance is |
|000017c0| 70 61 73 73 65 64 20 74 | 68 65 20 64 61 74 61 20 |passed t|he data |
|000017d0| 72 65 66 65 72 65 6e 63 | 65 20 74 6f 20 62 65 20 |referenc|e to be |
|000017e0| 75 73 65 64 2e 20 54 68 | 65 72 65 20 69 73 20 6e |used. Th|ere is n|
|000017f0| 6f 20 64 61 74 61 20 72 | 65 66 65 72 65 6e 63 65 |o data r|eference|
|00001800| 20 74 79 70 65 20 66 69 | 65 6c 64 20 61 73 20 77 | type fi|eld as w|
|00001810| 69 74 68 20 4d 6f 76 69 | 65 20 54 6f 6f 6c 62 6f |ith Movi|e Toolbo|
|00001820| 78 20 64 61 74 61 20 72 | 65 66 65 72 65 6e 63 65 |x data r|eference|
|00001830| 20 63 61 6c 6c 73 20 62 | 65 63 61 75 73 65 20 74 | calls b|ecause t|
|00001840| 68 65 20 64 61 74 61 20 | 68 61 6e 64 6c 65 72 20 |he data |handler |
|00001850| 74 6f 20 75 73 65 20 69 | 73 20 63 68 6f 73 65 6e |to use i|s chosen|
|00001860| 20 62 79 20 74 68 65 20 | 4d 6f 76 69 65 20 54 6f | by the |Movie To|
|00001870| 6f 6c 62 6f 78 20 62 61 | 73 65 64 20 6f 6e 20 74 |olbox ba|sed on t|
|00001880| 68 65 20 73 75 62 74 79 | 70 65 20 6f 66 20 74 68 |he subty|pe of th|
|00001890| 65 20 64 61 74 61 20 68 | 61 6e 64 6c 65 72 20 63 |e data h|andler c|
|000018a0| 6f 6d 70 6f 6e 65 6e 74 | 2e 20 54 68 65 72 65 66 |omponent|. Theref|
|000018b0| 6f 72 65 2c 20 74 68 65 | 20 74 79 70 65 20 6f 66 |ore, the| type of|
|000018c0| 20 74 68 65 20 64 61 74 | 61 20 72 65 66 65 72 65 | the dat|a refere|
|000018d0| 6e 63 65 20 69 73 20 61 | 6c 77 61 79 73 20 74 68 |nce is a|lways th|
|000018e0| 65 20 73 75 62 74 79 70 | 65 20 6f 66 20 74 68 65 |e subtyp|e of the|
|000018f0| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 63 6f | data ha|ndler co|
|00001900| 6d 70 6f 6e 65 6e 74 2e | 20 54 68 65 20 64 61 74 |mponent.| The dat|
|00001910| 61 20 68 61 6e 64 6c 65 | 72 20 69 73 20 72 65 73 |a handle|r is res|
|00001920| 70 6f 6e 73 69 62 6c 65 | 20 66 6f 72 20 6d 61 6b |ponsible| for mak|
|00001930| 69 6e 67 20 61 20 63 6f | 70 79 20 6f 66 20 74 68 |ing a co|py of th|
|00001940| 65 20 63 6f 6e 74 65 6e | 74 73 20 6f 66 20 74 68 |e conten|ts of th|
|00001950| 65 20 64 61 74 61 52 65 | 66 20 68 61 6e 64 6c 65 |e dataRe|f handle|
|00001960| 20 70 61 73 73 65 64 2e | 0d 70 61 73 63 61 6c 20 | passed.|.pascal |
|00001970| 43 6f 6d 70 6f 6e 65 6e | 74 52 65 73 75 6c 74 20 |Componen|tResult |
|00001980| 44 61 74 61 48 47 65 74 | 44 61 74 61 52 65 66 20 |DataHGet|DataRef |
|00001990| 28 44 61 74 61 48 61 6e | 64 6c 65 72 20 64 68 2c |(DataHan|dler dh,|
|000019a0| 20 48 61 6e 64 6c 65 20 | 2a 64 61 74 61 52 65 66 | Handle |*dataRef|
|000019b0| 20 29 0d 54 68 65 20 64 | 61 74 61 20 68 61 6e 64 | ).The d|ata hand|
|000019c0| 6c 65 72 20 6d 75 73 74 | 20 63 72 65 61 74 65 20 |ler must| create |
|000019d0| 61 20 63 6f 70 79 20 6f | 66 20 69 74 73 20 63 75 |a copy o|f its cu|
|000019e0| 72 72 65 6e 74 20 64 61 | 74 61 20 72 65 66 65 72 |rrent da|ta refer|
|000019f0| 65 6e 63 65 20 69 6e 20 | 61 20 68 61 6e 64 6c 65 |ence in |a handle|
|00001a00| 20 61 6e 64 20 72 65 74 | 75 72 6e 20 69 74 20 69 | and ret|urn it i|
|00001a10| 6e 20 2a 64 61 74 61 52 | 65 66 2e 20 54 68 65 20 |n *dataR|ef. The |
|00001a20| 63 61 6c 6c 65 72 20 69 | 73 20 72 65 73 70 6f 6e |caller i|s respon|
|00001a30| 73 69 62 6c 65 20 66 6f | 72 20 64 69 73 70 6f 73 |sible fo|r dispos|
|00001a40| 69 6e 67 20 6f 66 20 74 | 68 65 20 72 65 74 75 72 |ing of t|he retur|
|00001a50| 6e 65 64 20 64 61 74 61 | 20 72 65 66 65 72 65 6e |ned data| referen|
|00001a60| 63 65 20 68 61 6e 64 6c | 65 2e 0d 70 61 73 63 61 |ce handl|e..pasca|
|00001a70| 6c 20 43 6f 6d 70 6f 6e | 65 6e 74 52 65 73 75 6c |l Compon|entResul|
|00001a80| 74 20 44 61 74 61 48 43 | 6f 6d 70 61 72 65 44 61 |t DataHC|ompareDa|
|00001a90| 74 61 52 65 66 20 28 44 | 61 74 61 48 61 6e 64 6c |taRef (D|ataHandl|
|00001aa0| 65 72 20 64 68 2c 20 48 | 61 6e 64 6c 65 20 64 61 |er dh, H|andle da|
|00001ab0| 74 61 52 65 66 2c 20 42 | 6f 6f 6c 65 61 6e 20 2a |taRef, B|oolean *|
|00001ac0| 65 71 75 61 6c 20 29 0d | 54 68 65 20 64 61 74 61 |equal ).|The data|
|00001ad0| 20 68 61 6e 64 6c 65 72 | 20 6d 75 73 74 20 63 6f | handler| must co|
|00001ae0| 6d 70 61 72 65 20 74 68 | 65 20 70 61 73 73 65 64 |mpare th|e passed|
|00001af0| 20 64 61 74 61 20 72 65 | 66 65 72 65 6e 63 65 20 | data re|ference |
|00001b00| 77 69 74 68 20 69 74 73 | 20 63 75 72 72 65 6e 74 |with its| current|
|00001b10| 20 64 61 74 61 20 72 65 | 66 65 72 65 6e 63 65 2e | data re|ference.|
|00001b20| 20 54 68 65 20 76 61 6c | 75 65 20 6f 66 20 2a 65 | The val|ue of *e|
|00001b30| 71 75 61 6c 20 73 68 6f | 75 6c 64 20 62 65 20 73 |qual sho|uld be s|
|00001b40| 65 74 20 74 6f 20 74 72 | 75 65 20 69 66 20 74 68 |et to tr|ue if th|
|00001b50| 65 79 20 72 65 66 65 72 | 20 74 6f 20 74 68 65 20 |ey refer| to the |
|00001b60| 73 61 6d 65 20 66 69 6c | 65 2f d3 64 61 74 61 20 |same fil|e/.data |
|00001b70| 73 74 6f 72 61 67 65 20 | 70 6c 61 63 65 d3 2e 20 |storage |place.. |
|00001b80| 0d 70 61 73 63 61 6c 20 | 43 6f 6d 70 6f 6e 65 6e |.pascal |Componen|
|00001b90| 74 52 65 73 75 6c 74 20 | 44 61 74 61 48 52 65 73 |tResult |DataHRes|
|00001ba0| 6f 6c 76 65 44 61 74 61 | 52 65 66 20 28 44 61 74 |olveData|Ref (Dat|
|00001bb0| 61 48 61 6e 64 6c 65 72 | 20 64 68 2c 20 48 61 6e |aHandler| dh, Han|
|00001bc0| 64 6c 65 20 74 68 65 44 | 61 74 61 52 65 66 2c 20 |dle theD|ataRef, |
|00001bd0| 42 6f 6f 6c 65 61 6e 20 | 2a 77 61 73 43 68 61 6e |Boolean |*wasChan|
|00001be0| 67 65 64 2c 20 42 6f 6f | 6c 65 61 6e 20 75 73 65 |ged, Boo|lean use|
|00001bf0| 72 49 6e 74 65 72 66 61 | 63 65 41 6c 6c 6f 77 65 |rInterfa|ceAllowe|
|00001c00| 64 29 0d 54 68 65 20 64 | 61 74 61 20 68 61 6e 64 |d).The d|ata hand|
|00001c10| 6c 65 72 20 69 73 20 70 | 61 73 73 65 64 20 61 20 |ler is p|assed a |
|00001c20| 64 61 74 61 20 72 65 66 | 65 72 65 6e 63 65 2e 20 |data ref|erence. |
|00001c30| 49 74 20 73 68 6f 75 6c | 64 20 61 74 74 65 6d 70 |It shoul|d attemp|
|00001c40| 74 20 74 6f 20 6c 6f 63 | 61 74 65 20 74 68 65 20 |t to loc|ate the |
|00001c50| 66 69 6c 65 2f d3 64 61 | 74 61 20 73 74 6f 72 61 |file/.da|ta stora|
|00001c60| 67 65 20 70 6c 61 63 65 | d3 20 74 68 61 74 20 69 |ge place|. that i|
|00001c70| 74 20 72 65 66 65 72 65 | 6e 63 65 73 2e 20 49 66 |t refere|nces. If|
|00001c80| 20 74 68 65 20 64 61 74 | 61 20 72 65 66 65 72 65 | the dat|a refere|
|00001c90| 6e 63 65 20 73 68 6f 75 | 6c 64 20 62 65 20 75 70 |nce shou|ld be up|
|00001ca0| 64 61 74 65 64 20 74 6f | 20 6d 6f 72 65 20 63 6f |dated to| more co|
|00001cb0| 72 72 65 63 74 6c 79 20 | 64 65 73 63 72 69 62 65 |rrectly |describe|
|00001cc0| 20 74 68 65 20 6c 6f 63 | 61 74 69 6f 6e 20 6f 66 | the loc|ation of|
|00001cd0| 20 74 68 65 20 66 69 6c | 65 2c 20 74 68 65 20 63 | the fil|e, the c|
|00001ce0| 6f 6e 74 65 6e 74 73 20 | 6f 66 20 74 68 65 20 64 |ontents |of the d|
|00001cf0| 61 74 61 52 65 66 20 68 | 61 6e 64 6c 65 20 73 68 |ataRef h|andle sh|
|00001d00| 6f 75 6c 64 20 75 70 64 | 61 74 65 64 20 61 6e 64 |ould upd|ated and|
|00001d10| 20 74 68 65 20 2a 77 61 | 73 43 68 61 6e 67 65 64 | the *wa|sChanged|
|00001d20| 20 66 6c 61 67 20 73 65 | 74 20 74 6f 20 74 72 75 | flag se|t to tru|
|00001d30| 65 2e 20 49 66 20 74 68 | 65 20 75 73 65 72 49 6e |e. If th|e userIn|
|00001d40| 74 65 72 66 61 63 65 41 | 6c 6c 6f 77 65 64 20 66 |terfaceA|llowed f|
|00001d50| 6c 61 67 20 69 73 20 73 | 65 74 20 74 6f 20 74 72 |lag is s|et to tr|
|00001d60| 75 65 2c 20 74 68 65 20 | 64 61 74 61 20 68 61 6e |ue, the |data han|
|00001d70| 64 6c 65 72 20 6d 61 79 | 20 69 6e 74 65 72 61 63 |dler may| interac|
|00001d80| 74 20 77 69 74 68 20 74 | 68 65 20 75 73 65 72 20 |t with t|he user |
|00001d90| 74 6f 20 68 65 6c 70 20 | 6c 6f 63 61 74 65 20 74 |to help |locate t|
|00001da0| 68 65 20 66 69 6c 65 2e | 20 20 44 61 74 61 48 52 |he file.|  DataHR|
|00001db0| 65 73 6f 6c 76 65 44 61 | 74 61 52 65 66 20 69 73 |esolveDa|taRef is|
|00001dc0| 20 72 6f 75 67 68 6c 79 | 20 65 71 75 69 76 61 6c | roughly| equival|
|00001dd0| 65 6e 74 20 74 6f 20 74 | 68 65 20 41 6c 69 61 73 |ent to t|he Alias|
|00001de0| 20 4d 61 6e 61 67 65 72 | d5 73 20 52 65 73 6f 6c | Manager|.s Resol|
|00001df0| 76 65 41 6c 69 61 73 20 | 63 61 6c 6c 2e 0d 44 61 |veAlias |call..Da|
|00001e00| 74 61 20 52 65 66 65 72 | 65 6e 63 65 20 4f 70 65 |ta Refer|ence Ope|
|00001e10| 6e 2f 43 6c 6f 73 65 0d | 70 61 73 63 61 6c 20 43 |n/Close.|pascal C|
|00001e20| 6f 6d 70 6f 6e 65 6e 74 | 52 65 73 75 6c 74 20 44 |omponent|Result D|
|00001e30| 61 74 61 48 4f 70 65 6e | 46 6f 72 52 65 61 64 20 |ataHOpen|ForRead |
|00001e40| 28 44 61 74 61 48 61 6e | 64 6c 65 72 20 64 68 29 |(DataHan|dler dh)|
|00001e50| 0d 54 68 65 20 44 61 74 | 61 20 48 61 6e 64 6c 65 |.The Dat|a Handle|
|00001e60| 72 20 73 68 6f 75 6c 64 | 20 61 74 74 65 6d 70 74 |r should| attempt|
|00001e70| 20 74 6f 20 6f 70 65 6e | 20 61 20 72 65 61 64 20 | to open| a read |
|00001e80| 6f 6e 6c 79 20 61 63 63 | 65 73 73 20 70 61 74 68 |only acc|ess path|
|00001e90| 20 74 6f 20 74 68 65 20 | 63 75 72 72 65 6e 74 6c | to the |currentl|
|00001ea0| 79 20 64 61 74 61 20 72 | 65 66 65 72 65 6e 63 65 |y data r|eference|
|00001eb0| 2e 20 49 66 20 74 68 65 | 20 66 69 6c 65 20 69 73 |. If the| file is|
|00001ec0| 20 61 6c 72 65 61 64 79 | 20 6f 70 65 6e 20 66 6f | already| open fo|
|00001ed0| 72 20 72 65 61 64 2c 20 | 61 6e 20 65 72 72 6f 72 |r read, |an error|
|00001ee0| 20 73 68 6f 75 6c 64 20 | 62 65 20 72 65 74 75 72 | should |be retur|
|00001ef0| 6e 65 64 2e 20 0d 70 61 | 73 63 61 6c 20 43 6f 6d |ned. .pa|scal Com|
|00001f00| 70 6f 6e 65 6e 74 52 65 | 73 75 6c 74 20 44 61 74 |ponentRe|sult Dat|
|00001f10| 61 48 43 6c 6f 73 65 46 | 6f 72 52 65 61 64 20 28 |aHCloseF|orRead (|
|00001f20| 44 61 74 61 48 61 6e 64 | 6c 65 72 20 64 68 29 0d |DataHand|ler dh).|
|00001f30| 54 68 65 20 44 61 74 61 | 20 48 61 6e 64 6c 65 72 |The Data| Handler|
|00001f40| 20 73 68 6f 75 6c 64 20 | 63 6c 6f 73 65 20 64 6f | should |close do|
|00001f50| 77 6e 20 69 74 73 20 72 | 65 61 64 20 61 63 63 65 |wn its r|ead acce|
|00001f60| 73 73 20 70 61 74 68 2e | 20 49 74 20 69 73 20 70 |ss path.| It is p|
|00001f70| 6f 73 73 69 62 6c 65 20 | 74 68 61 74 20 74 68 65 |ossible |that the|
|00001f80| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 77 69 | data ha|ndler wi|
|00001f90| 6c 6c 20 62 65 20 63 6c | 6f 73 65 64 20 77 68 69 |ll be cl|osed whi|
|00001fa0| 6c 65 20 72 65 61 64 20 | 61 63 63 65 73 73 20 70 |le read |access p|
|00001fb0| 61 74 68 20 69 73 20 6f | 70 65 6e 2e 20 49 66 20 |ath is o|pen. If |
|00001fc0| 74 68 69 73 20 6f 63 63 | 75 72 73 2c 20 74 68 65 |this occ|urs, the|
|00001fd0| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 73 68 | data ha|ndler sh|
|00001fe0| 6f 75 6c 64 20 63 6c 6f | 73 65 20 74 68 65 20 72 |ould clo|se the r|
|00001ff0| 65 61 64 20 70 61 74 68 | 20 64 6f 77 6e 20 62 65 |ead path| down be|
|00002000| 66 6f 72 65 20 63 6c 6f | 73 69 6e 67 2e 0d 70 61 |fore clo|sing..pa|
|00002010| 73 63 61 6c 20 43 6f 6d | 70 6f 6e 65 6e 74 52 65 |scal Com|ponentRe|
|00002020| 73 75 6c 74 20 44 61 74 | 61 48 4f 70 65 6e 46 6f |sult Dat|aHOpenFo|
|00002030| 72 57 72 69 74 65 20 28 | 44 61 74 61 48 61 6e 64 |rWrite (|DataHand|
|00002040| 6c 65 72 20 64 68 29 0d | 54 68 65 20 44 61 74 61 |ler dh).|The Data|
|00002050| 20 48 61 6e 64 6c 65 72 | 20 73 68 6f 75 6c 64 20 | Handler| should |
|00002060| 61 74 74 65 6d 70 74 20 | 74 6f 20 6f 70 65 6e 20 |attempt |to open |
|00002070| 61 20 77 72 69 74 65 20 | 6f 6e 6c 79 20 61 63 63 |a write |only acc|
|00002080| 65 73 73 20 70 61 74 68 | 20 74 6f 20 74 68 65 20 |ess path| to the |
|00002090| 63 75 72 72 65 6e 74 6c | 79 20 64 61 74 61 20 72 |currentl|y data r|
|000020a0| 65 66 65 72 65 6e 63 65 | 2e 20 49 66 20 74 68 65 |eference|. If the|
|000020b0| 20 66 69 6c 65 20 69 73 | 20 61 6c 72 65 61 64 79 | file is| already|
|000020c0| 20 6f 70 65 6e 20 66 6f | 72 20 77 72 69 74 65 2c | open fo|r write,|
|000020d0| 20 61 6e 20 65 72 72 6f | 72 20 73 68 6f 75 6c 64 | an erro|r should|
|000020e0| 20 62 65 20 72 65 74 75 | 72 6e 65 64 2e 0d 70 61 | be retu|rned..pa|
|000020f0| 73 63 61 6c 20 43 6f 6d | 70 6f 6e 65 6e 74 52 65 |scal Com|ponentRe|
|00002100| 73 75 6c 74 20 44 61 74 | 61 48 43 6c 6f 73 65 46 |sult Dat|aHCloseF|
|00002110| 6f 72 57 72 69 74 65 20 | 28 44 61 74 61 48 61 6e |orWrite |(DataHan|
|00002120| 64 6c 65 72 20 64 68 29 | 0d 54 68 65 20 44 61 74 |dler dh)|.The Dat|
|00002130| 61 20 48 61 6e 64 6c 65 | 72 20 73 68 6f 75 6c 64 |a Handle|r should|
|00002140| 20 63 6c 6f 73 65 20 64 | 6f 77 6e 20 69 74 73 20 | close d|own its |
|00002150| 77 72 69 74 65 20 61 63 | 63 65 73 73 20 70 61 74 |write ac|cess pat|
|00002160| 68 2e 20 49 74 20 69 73 | 20 70 6f 73 73 69 62 6c |h. It is| possibl|
|00002170| 65 20 74 68 61 74 20 74 | 68 65 20 44 61 74 61 20 |e that t|he Data |
|00002180| 48 61 6e 64 6c 65 72 20 | 77 69 6c 6c 20 62 65 20 |Handler |will be |
|00002190| 63 6c 6f 73 65 64 20 77 | 68 69 6c 65 20 77 72 69 |closed w|hile wri|
|000021a0| 74 65 20 61 63 63 65 73 | 73 20 70 61 74 68 20 69 |te acces|s path i|
|000021b0| 73 20 6f 70 65 6e 2e 20 | 49 66 20 74 68 69 73 20 |s open. |If this |
|000021c0| 6f 63 63 75 72 73 2c 20 | 74 68 65 20 44 61 74 61 |occurs, |the Data|
|000021d0| 20 48 61 6e 64 6c 65 72 | 20 73 68 6f 75 6c 64 20 | Handler| should |
|000021e0| 63 6c 6f 73 65 20 74 68 | 65 20 77 72 69 74 65 20 |close th|e write |
|000021f0| 70 61 74 68 20 64 6f 77 | 6e 20 62 65 66 6f 72 65 |path dow|n before|
|00002200| 20 63 6c 6f 73 69 6e 67 | 2e 0d 44 61 74 61 20 52 | closing|..Data R|
|00002210| 65 66 65 72 65 6e 63 65 | 20 52 65 61 64 2f 57 72 |eference| Read/Wr|
|00002220| 69 74 65 0d 46 6f 72 20 | 68 69 73 74 6f 72 69 63 |ite.For |historic|
|00002230| 20 72 65 61 73 6f 6e 73 | 2c 20 69 74 20 70 6f 73 | reasons|, it pos|
|00002240| 73 69 62 6c 65 20 74 68 | 61 74 20 61 20 72 65 71 |sible th|at a req|
|00002250| 75 65 73 74 20 74 6f 20 | 72 65 61 64 20 64 61 74 |uest to |read dat|
|00002260| 61 20 77 69 6c 6c 20 62 | 65 20 69 73 73 75 65 64 |a will b|e issued|
|00002270| 20 62 65 66 6f 72 65 20 | 74 68 65 20 64 61 74 61 | before |the data|
|00002280| 20 72 65 66 65 72 65 6e | 63 65 20 68 61 73 20 62 | referen|ce has b|
|00002290| 65 65 6e 20 6f 70 65 6e | 65 64 20 66 6f 72 20 72 |een open|ed for r|
|000022a0| 65 61 64 2e 20 49 6e 20 | 74 68 69 73 20 63 61 73 |ead. In |this cas|
|000022b0| 65 2c 20 74 68 65 20 64 | 61 74 61 20 68 61 6e 64 |e, the d|ata hand|
|000022c0| 6c 65 72 20 73 68 6f 75 | 6c 64 20 6f 70 65 6e 20 |ler shou|ld open |
|000022d0| 74 68 65 20 64 61 74 61 | 20 72 65 66 65 72 65 6e |the data| referen|
|000022e0| 63 65 20 66 6f 72 20 72 | 65 61 64 2c 20 61 6e 64 |ce for r|ead, and|
|000022f0| 20 6c 65 61 76 65 20 69 | 74 20 6f 70 65 6e 2e 0d | leave i|t open..|
|00002300| 70 61 73 63 61 6c 20 43 | 6f 6d 70 6f 6e 65 6e 74 |pascal C|omponent|
|00002310| 52 65 73 75 6c 74 20 44 | 61 74 61 48 47 65 74 44 |Result D|ataHGetD|
|00002320| 61 74 61 20 28 44 61 74 | 61 48 61 6e 64 6c 65 72 |ata (Dat|aHandler|
|00002330| 20 64 68 2c 20 48 61 6e | 64 6c 65 20 68 2c 20 6c | dh, Han|dle h, l|
|00002340| 6f 6e 67 20 68 4f 66 66 | 73 65 74 2c 20 6c 6f 6e |ong hOff|set, lon|
|00002350| 67 20 6f 66 66 73 65 74 | 2c 20 6c 6f 6e 67 20 73 |g offset|, long s|
|00002360| 69 7a 65 29 0d 44 61 74 | 61 48 47 65 74 44 61 74 |ize).Dat|aHGetDat|
|00002370| 61 20 69 73 20 74 68 65 | 20 73 79 6e 63 68 72 6f |a is the| synchro|
|00002380| 6e 6f 75 73 20 68 69 67 | 68 20 6c 65 76 65 6c 20 |nous hig|h level |
|00002390| 72 65 61 64 20 63 61 6c | 6c 20 69 6e 20 74 68 65 |read cal|l in the|
|000023a0| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 69 6e | data ha|ndler in|
|000023b0| 74 65 72 66 61 63 65 2e | 20 54 68 65 20 6c 6f 63 |terface.| The loc|
|000023c0| 61 74 69 6f 6e 20 74 6f | 20 72 65 61 64 20 66 72 |ation to| read fr|
|000023d0| 6f 6d 20 74 68 65 20 64 | 61 74 61 52 65 66 65 72 |om the d|ataRefer|
|000023e0| 65 6e 63 65 20 69 73 20 | 70 61 73 73 65 64 20 69 |ence is |passed i|
|000023f0| 6e 20 6f 66 66 73 65 74 | 2c 20 61 6e 64 20 74 68 |n offset|, and th|
|00002400| 65 20 61 6d 6f 75 6e 74 | 20 6f 66 20 64 61 74 61 |e amount| of data|
|00002410| 20 74 6f 20 72 65 61 64 | 20 69 73 20 70 61 73 73 | to read| is pass|
|00002420| 65 64 20 69 6e 20 73 69 | 7a 65 2e 20 54 68 65 20 |ed in si|ze. The |
|00002430| 64 61 74 61 20 73 68 6f | 75 6c 64 20 62 65 20 72 |data sho|uld be r|
|00002440| 65 61 64 20 69 6e 74 6f | 20 74 68 65 20 48 61 6e |ead into| the Han|
|00002450| 64 6c 65 20 68 20 73 74 | 61 72 74 69 6e 67 20 61 |dle h st|arting a|
|00002460| 74 20 6f 66 66 73 65 74 | 20 68 4f 66 66 73 65 74 |t offset| hOffset|
|00002470| 2e 0d 70 61 73 63 61 6c | 20 43 6f 6d 70 6f 6e 65 |..pascal| Compone|
|00002480| 6e 74 52 65 73 75 6c 74 | 20 44 61 74 61 48 50 75 |ntResult| DataHPu|
|00002490| 74 44 61 74 61 20 28 44 | 61 74 61 48 61 6e 64 6c |tData (D|ataHandl|
|000024a0| 65 72 20 64 68 2c 20 48 | 61 6e 64 6c 65 20 68 2c |er dh, H|andle h,|
|000024b0| 20 6c 6f 6e 67 20 68 4f | 66 66 73 65 74 2c 20 6c | long hO|ffset, l|
|000024c0| 6f 6e 67 20 2a 6f 66 66 | 73 65 74 2c 20 6c 6f 6e |ong *off|set, lon|
|000024d0| 67 20 73 69 7a 65 20 29 | 0d 44 61 74 61 48 47 65 |g size )|.DataHGe|
|000024e0| 74 44 61 74 61 20 69 73 | 20 74 68 65 20 70 72 69 |tData is| the pri|
|000024f0| 6d 61 72 79 20 77 72 69 | 74 65 20 63 61 6c 6c 20 |mary wri|te call |
|00002500| 69 6e 20 74 68 65 20 64 | 61 74 61 20 68 61 6e 64 |in the d|ata hand|
|00002510| 6c 65 72 20 69 6e 74 65 | 72 66 61 63 65 2e 20 54 |ler inte|rface. T|
|00002520| 68 65 20 61 6d 6f 75 6e | 74 20 6f 66 20 64 61 74 |he amoun|t of dat|
|00002530| 61 20 74 6f 20 72 65 61 | 64 20 69 73 20 70 61 73 |a to rea|d is pas|
|00002540| 73 65 64 20 69 6e 20 73 | 69 7a 65 2e 20 54 68 65 |sed in s|ize. The|
|00002550| 20 6c 6f 63 61 74 69 6f | 6e 20 74 68 61 74 20 74 | locatio|n that t|
|00002560| 68 65 20 64 61 74 61 20 | 77 61 73 20 77 72 69 74 |he data |was writ|
|00002570| 74 65 6e 20 61 74 20 69 | 73 20 72 65 74 75 72 6e |ten at i|s return|
|00002580| 65 64 20 69 6e 20 6f 66 | 66 73 65 74 2e 20 44 61 |ed in of|fset. Da|
|00002590| 74 61 20 73 68 6f 75 6c | 64 20 61 6c 77 61 79 73 |ta shoul|d always|
|000025a0| 20 62 65 20 61 70 70 65 | 6e 64 65 64 20 74 6f 20 | be appe|nded to |
|000025b0| 74 68 65 20 65 6e 64 20 | 6f 66 20 74 68 65 20 64 |the end |of the d|
|000025c0| 61 74 61 20 72 65 66 65 | 72 65 6e 63 65 20 77 68 |ata refe|rence wh|
|000025d0| 65 6e 20 44 61 79 74 61 | 48 50 75 74 44 61 74 61 |en Dayta|HPutData|
|000025e0| 20 69 73 20 75 73 65 64 | 2e 20 54 68 65 20 61 63 | is used|. The ac|
|000025f0| 74 75 61 6c 20 64 61 74 | 61 20 74 6f 20 77 72 69 |tual dat|a to wri|
|00002600| 74 65 20 69 73 20 63 6f | 6e 74 61 69 6e 65 64 20 |te is co|ntained |
|00002610| 69 6e 20 74 68 65 20 48 | 61 6e 64 6c 65 20 68 20 |in the H|andle h |
|00002620| 73 74 61 72 74 69 6e 67 | 20 61 74 20 6f 66 66 73 |starting| at offs|
|00002630| 65 74 20 68 4f 66 66 73 | 65 74 2e 0d 70 61 73 63 |et hOffs|et..pasc|
|00002640| 61 6c 20 43 6f 6d 70 6f | 6e 65 6e 74 52 65 73 75 |al Compo|nentResu|
|00002650| 6c 74 20 44 61 74 61 48 | 53 63 68 65 64 75 6c 65 |lt DataH|Schedule|
|00002660| 44 61 74 61 20 28 44 61 | 74 61 48 61 6e 64 6c 65 |Data (Da|taHandle|
|00002670| 72 20 64 68 2c 20 50 74 | 72 20 50 6c 61 63 65 54 |r dh, Pt|r PlaceT|
|00002680| 6f 50 75 74 44 61 74 61 | 50 74 72 2c 6c 6f 6e 67 |oPutData|Ptr,long|
|00002690| 20 46 69 6c 65 4f 66 66 | 73 65 74 2c 20 6c 6f 6e | FileOff|set, lon|
|000026a0| 67 20 44 61 74 61 53 69 | 7a 65 2c 20 6c 6f 6e 67 |g DataSi|ze, long|
|000026b0| 20 52 65 66 43 6f 6e 2c | 20 44 61 74 61 48 53 63 | RefCon,| DataHSc|
|000026c0| 68 65 64 75 6c 65 50 74 | 72 20 73 63 68 65 64 75 |hedulePt|r schedu|
|000026d0| 6c 65 52 65 63 2c 20 44 | 48 43 6f 6d 70 6c 65 74 |leRec, D|HComplet|
|000026e0| 65 50 72 6f 63 20 43 6f | 6d 70 6c 65 74 69 6f 6e |eProc Co|mpletion|
|000026f0| 52 74 6e 20 29 0d 44 61 | 74 61 48 53 63 68 65 64 |Rtn ).Da|taHSched|
|00002700| 75 6c 65 44 61 74 61 20 | 20 69 73 20 74 68 65 20 |uleData | is the |
|00002710| 6c 6f 77 20 6c 65 76 65 | 72 20 72 65 61 64 20 63 |low leve|r read c|
|00002720| 61 6c 6c 20 69 6e 20 74 | 68 65 20 64 61 74 61 20 |all in t|he data |
|00002730| 68 61 6e 64 6c 65 72 20 | 69 6e 74 65 72 66 61 63 |handler |interfac|
|00002740| 65 2e 20 49 74 20 61 6c | 6c 6f 77 73 20 66 6f 72 |e. It al|lows for|
|00002750| 20 66 75 6c 6c 79 20 61 | 73 79 6e 63 68 72 6f 6e | fully a|synchron|
|00002760| 6f 75 73 20 72 65 61 64 | 73 2e 20 54 68 65 20 6c |ous read|s. The l|
|00002770| 6f 63 61 74 69 6f 6e 20 | 74 6f 20 72 65 61 64 20 |ocation |to read |
|00002780| 74 68 65 20 64 61 74 61 | 20 69 6e 20 74 68 65 20 |the data| in the |
|00002790| 64 61 74 61 20 72 65 66 | 65 72 65 6e 63 65 20 69 |data ref|erence i|
|000027a0| 73 20 70 61 73 73 65 64 | 20 69 6e 20 46 69 6c 65 |s passed| in File|
|000027b0| 4f 66 66 73 65 74 2e 20 | 54 68 65 20 61 6d 6f 75 |Offset. |The amou|
|000027c0| 6e 74 20 6f 66 20 64 61 | 74 61 20 74 6f 20 72 65 |nt of da|ta to re|
|000027d0| 61 64 20 69 73 20 70 61 | 73 73 65 64 20 69 6e 20 |ad is pa|ssed in |
|000027e0| 44 61 74 61 53 69 7a 65 | 2e 20 54 68 65 20 64 61 |DataSize|. The da|
|000027f0| 74 61 20 73 68 6f 75 6c | 64 20 62 65 20 70 6c 61 |ta shoul|d be pla|
|00002800| 63 65 64 20 69 6e 74 6f | 20 6d 65 6d 6f 72 79 20 |ced into| memory |
|00002810| 73 74 61 72 74 69 6e 67 | 20 61 74 20 74 68 65 20 |starting| at the |
|00002820| 6c 6f 63 61 74 69 6f 6e | 20 73 70 65 63 69 66 69 |location| specifi|
|00002830| 65 64 20 62 79 20 50 6c | 61 63 65 54 6f 50 75 74 |ed by Pl|aceToPut|
|00002840| 44 61 74 61 50 74 72 2e | 20 41 66 74 65 72 20 74 |DataPtr.| After t|
|00002850| 68 65 20 64 61 74 61 20 | 68 61 73 20 62 65 65 6e |he data |has been|
|00002860| 20 72 65 61 64 2c 20 69 | 66 20 74 68 65 20 43 6f | read, i|f the Co|
|00002870| 6d 70 6c 65 74 69 6f 6e | 20 72 6f 75 74 69 6e 65 |mpletion| routine|
|00002880| 20 69 73 20 70 72 6f 76 | 69 64 65 64 2c 20 69 74 | is prov|ided, it|
|00002890| 20 6d 75 73 74 20 62 65 | 20 63 61 6c 6c 65 64 20 | must be| called |
|000028a0| 77 69 74 68 20 74 68 65 | 20 52 65 66 43 6f 6e 20 |with the| RefCon |
|000028b0| 70 61 73 73 65 64 20 69 | 6e 2e 20 54 68 65 20 43 |passed i|n. The C|
|000028c0| 6f 6d 70 6c 65 74 69 6f | 6e 20 72 6f 75 74 69 6e |ompletio|n routin|
|000028d0| 65 20 6d 75 73 74 20 62 | 65 20 63 61 6c 6c 65 64 |e must b|e called|
|000028e0| 2c 20 65 76 65 6e 20 69 | 66 20 74 68 65 20 72 65 |, even i|f the re|
|000028f0| 61 64 20 66 61 69 6c 73 | 2e 20 49 66 20 74 68 65 |ad fails|. If the|
|00002900| 20 73 63 68 65 64 75 6c | 65 52 65 63 20 66 69 65 | schedul|eRec fie|
|00002910| 6c 64 20 69 73 20 6e 69 | 6c 2c 20 74 68 65 6e 20 |ld is ni|l, then |
|00002920| 44 61 74 61 48 53 63 68 | 65 64 75 6c 65 44 61 74 |DataHSch|eduleDat|
|00002930| 61 20 69 73 20 61 20 73 | 79 6e 63 68 72 6f 6e 6f |a is a s|ynchrono|
|00002940| 75 73 20 72 65 61 64 2c | 20 69 2e 65 2e 20 74 68 |us read,| i.e. th|
|00002950| 65 20 64 61 74 61 20 6d | 75 73 74 20 62 65 20 64 |e data m|ust be d|
|00002960| 65 6c 69 76 65 72 65 64 | 20 62 79 20 74 68 65 20 |elivered| by the |
|00002970| 74 69 6d 65 20 44 61 74 | 61 48 53 63 68 65 64 75 |time Dat|aHSchedu|
|00002980| 6c 65 44 61 74 61 20 72 | 65 74 75 72 6e 73 2e 20 |leData r|eturns. |
|00002990| 49 66 20 74 68 65 20 73 | 63 68 65 64 75 6c 65 52 |If the s|cheduleR|
|000029a0| 65 63 20 66 69 65 6c 64 | 20 69 73 20 6e 6f 74 20 |ec field| is not |
|000029b0| 6e 69 6c 20 69 74 20 70 | 6f 69 6e 74 73 20 74 6f |nil it p|oints to|
|000029c0| 20 61 20 44 61 74 61 48 | 53 63 68 65 64 75 6c 65 | a DataH|Schedule|
|000029d0| 52 65 63 6f 72 64 20 63 | 6f 6e 74 61 69 6e 69 6e |Record c|ontainin|
|000029e0| 67 20 73 63 68 65 64 75 | 6c 69 6e 67 20 69 6e 66 |g schedu|ling inf|
|000029f0| 6f 72 6d 61 74 69 6f 6e | 2e 0d 74 79 70 65 64 65 |ormation|..typede|
|00002a00| 66 20 73 74 72 75 63 74 | 20 44 61 74 61 48 53 63 |f struct| DataHSc|
|00002a10| 68 65 64 75 6c 65 52 65 | 63 6f 72 64 20 7b 0d 09 |heduleRe|cord {..|
|00002a20| 54 69 6d 65 52 65 63 6f | 72 64 09 74 69 6d 65 4e |TimeReco|rd.timeN|
|00002a30| 65 65 64 65 64 42 79 3b | 0d 09 6c 6f 6e 67 09 09 |eededBy;|..long..|
|00002a40| 65 78 74 65 6e 64 65 64 | 49 44 3b 0d 09 6c 6f 6e |extended|ID;..lon|
|00002a50| 67 09 09 65 78 74 65 6e | 64 65 64 56 65 72 73 3b |g..exten|dedVers;|
|00002a60| 0d 09 46 69 78 65 64 09 | 09 70 72 69 6f 72 69 74 |..Fixed.|.priorit|
|00002a70| 79 3b 0d 7d 20 44 61 74 | 61 48 53 63 68 65 64 75 |y;.} Dat|aHSchedu|
|00002a80| 6c 65 52 65 63 6f 72 64 | 2c 20 2a 44 61 74 61 48 |leRecord|, *DataH|
|00002a90| 53 63 68 65 64 75 6c 65 | 50 74 72 3b 0d 23 64 65 |Schedule|Ptr;.#de|
|00002aa0| 66 69 6e 65 20 6b 44 61 | 74 61 48 45 78 74 65 6e |fine kDa|taHExten|
|00002ab0| 64 65 64 53 63 68 65 64 | 75 6c 65 20 27 78 74 6e |dedSched|ule 'xtn|
|00002ac0| 64 27 0d 54 68 65 20 74 | 69 6d 65 4e 65 65 64 65 |d'.The t|imeNeede|
|00002ad0| 64 42 79 20 66 69 65 6c | 64 20 69 6e 20 74 68 65 |dBy fiel|d in the|
|00002ae0| 20 44 61 74 61 48 53 63 | 68 65 64 75 6c 65 52 65 | DataHSc|heduleRe|
|00002af0| 63 6f 72 64 20 73 70 65 | 63 69 66 69 65 73 20 74 |cord spe|cifies t|
|00002b00| 68 65 20 74 69 6d 65 20 | 61 74 20 77 68 69 63 68 |he time |at which|
|00002b10| 20 74 68 65 20 64 61 74 | 61 20 6d 75 73 74 20 62 | the dat|a must b|
|00002b20| 65 20 64 65 6c 69 76 65 | 72 65 64 2e 20 54 68 69 |e delive|red. Thi|
|00002b30| 73 20 74 69 6d 65 20 69 | 73 20 73 70 65 63 69 66 |s time i|s specif|
|00002b40| 69 65 64 20 72 65 6c 61 | 74 69 76 65 20 74 6f 20 |ied rela|tive to |
|00002b50| 74 68 65 20 54 69 6d 65 | 42 61 73 65 20 63 6f 6e |the Time|Base con|
|00002b60| 74 61 69 6e 65 64 20 69 | 6e 20 74 68 65 20 74 69 |tained i|n the ti|
|00002b70| 6d 65 4e 65 65 64 65 64 | 42 79 20 54 69 6d 65 52 |meNeeded|By TimeR|
|00002b80| 65 63 6f 72 64 2e 20 54 | 68 65 20 72 65 6d 61 69 |ecord. T|he remai|
|00002b90| 6e 69 6e 67 20 66 69 65 | 6c 64 73 20 69 6e 20 74 |ning fie|lds in t|
|00002ba0| 68 65 20 44 61 74 61 48 | 53 63 68 65 64 75 6c 65 |he DataH|Schedule|
|00002bb0| 52 65 63 6f 72 64 20 61 | 72 65 20 6f 70 74 69 6f |Record a|re optio|
|00002bc0| 6e 61 6c 2e 20 49 66 20 | 74 68 65 20 65 78 74 65 |nal. If |the exte|
|00002bd0| 6e 64 65 64 49 44 20 66 | 69 65 6c 64 20 69 73 20 |ndedID f|ield is |
|00002be0| 65 71 75 61 6c 20 74 6f | 20 74 68 65 20 63 6f 6e |equal to| the con|
|00002bf0| 73 74 61 6e 74 20 20 20 | 6b 44 61 74 61 48 45 78 |stant   |kDataHEx|
|00002c00| 74 65 6e 64 65 64 53 63 | 68 65 64 75 6c 65 2c 20 |tendedSc|hedule, |
|00002c10| 74 68 65 6e 20 74 68 65 | 20 72 65 6d 61 69 6e 69 |then the| remaini|
|00002c20| 6e 67 20 66 69 65 6c 64 | 73 20 61 72 65 20 76 61 |ng field|s are va|
|00002c30| 6c 69 64 2c 20 6f 74 68 | 65 72 77 69 73 65 20 74 |lid, oth|erwise t|
|00002c40| 68 65 79 20 73 68 6f 75 | 6c 64 20 62 65 20 69 67 |hey shou|ld be ig|
|00002c50| 6e 6f 72 65 64 2e 20 54 | 68 65 20 65 78 74 65 6e |nored. T|he exten|
|00002c60| 64 65 64 56 65 72 73 20 | 66 69 65 6c 64 20 73 68 |dedVers |field sh|
|00002c70| 6f 75 6c 64 20 63 75 72 | 72 65 6e 74 6c 79 20 61 |ould cur|rently a|
|00002c80| 6c 77 61 79 73 20 62 65 | 20 73 65 74 20 74 6f 20 |lways be| set to |
|00002c90| 7a 65 72 6f 2e 20 54 68 | 65 20 70 72 69 6f 72 69 |zero. Th|e priori|
|00002ca0| 74 79 20 66 69 65 6c 64 | 20 69 6e 64 69 63 61 74 |ty field| indicat|
|00002cb0| 65 73 20 68 6f 77 20 69 | 6d 70 6f 72 74 61 6e 74 |es how i|mportant|
|00002cc0| 20 74 68 65 20 64 61 74 | 61 20 69 73 2e 20 41 20 | the dat|a is. A |
|00002cd0| 70 72 69 6f 72 69 74 79 | 20 76 61 6c 75 65 20 6f |priority| value o|
|00002ce0| 66 20 31 30 30 2e 30 20 | 6d 65 61 6e 73 20 74 68 |f 100.0 |means th|
|00002cf0| 65 20 64 61 74 61 20 6d | 75 73 74 20 62 65 20 64 |e data m|ust be d|
|00002d00| 65 6c 69 76 65 72 65 64 | 2c 20 6c 6f 77 65 72 20 |elivered|, lower |
|00002d10| 6e 75 6d 62 65 72 73 20 | 69 6e 64 69 63 61 74 65 |numbers |indicate|
|00002d20| 20 6c 65 73 73 20 63 72 | 69 74 69 63 61 6c 20 64 | less cr|itical d|
|00002d30| 61 74 61 2e 20 50 72 69 | 6f 72 69 74 79 20 76 61 |ata. Pri|ority va|
|00002d40| 6c 75 65 73 20 6d 61 79 | 20 62 65 20 75 73 65 64 |lues may| be used|
|00002d50| 20 62 79 20 64 61 74 61 | 20 68 61 6e 64 6c 65 72 | by data| handler|
|00002d60| 73 20 77 68 69 63 68 20 | 6e 65 65 64 20 74 6f 20 |s which |need to |
|00002d70| 6d 61 6b 65 20 64 65 63 | 69 73 69 6f 6e 73 20 61 |make dec|isions a|
|00002d80| 62 6f 75 74 20 77 68 61 | 74 20 64 61 74 61 20 74 |bout wha|t data t|
|00002d90| 6f 20 64 72 6f 70 20 69 | 6e 20 63 61 73 65 73 20 |o drop i|n cases |
|00002da0| 6f 66 20 6c 69 6d 69 74 | 65 64 20 62 61 6e 64 77 |of limit|ed bandw|
|00002db0| 69 64 74 68 2e 20 0d 70 | 61 73 63 61 6c 20 43 6f |idth. .p|ascal Co|
|00002dc0| 6d 70 6f 6e 65 6e 74 52 | 65 73 75 6c 74 20 44 61 |mponentR|esult Da|
|00002dd0| 74 61 48 46 69 6e 69 73 | 68 44 61 74 61 20 28 44 |taHFinis|hData (D|
|00002de0| 61 74 61 48 61 6e 64 6c | 65 72 20 64 68 2c 20 50 |ataHandl|er dh, P|
|00002df0| 74 72 20 50 6c 61 63 65 | 54 6f 50 75 74 44 61 74 |tr Place|ToPutDat|
|00002e00| 61 50 74 72 2c 20 42 6f | 6f 6c 65 61 6e 20 43 61 |aPtr, Bo|olean Ca|
|00002e10| 6e 63 65 6c 20 29 0d 55 | 6e 64 65 72 20 73 6f 6d |ncel ).U|nder som|
|00002e20| 65 20 63 69 72 63 75 6d | 73 74 61 6e 63 65 73 2c |e circum|stances,|
|00002e30| 20 61 20 63 6c 69 65 6e | 74 20 6f 66 20 74 68 65 | a clien|t of the|
|00002e40| 20 64 61 74 61 20 68 61 | 6e 64 6c 65 72 20 6d 61 | data ha|ndler ma|
|00002e50| 79 20 6e 65 65 64 20 74 | 6f 20 63 61 6e 63 65 6c |y need t|o cancel|
|00002e60| 20 61 20 70 65 6e 64 69 | 6e 67 20 72 65 61 64 20 | a pendi|ng read |
|00002e70| 72 65 71 75 65 73 74 20 | 6d 61 64 65 20 77 69 74 |request |made wit|
|00002e80| 68 20 44 61 74 61 48 53 | 63 68 65 64 75 6c 65 44 |h DataHS|cheduleD|
|00002e90| 61 74 61 2e 20 4f 6e 20 | 6f 74 68 65 72 20 6f 63 |ata. On |other oc|
|00002ea0| 63 61 73 73 69 6f 6e 73 | 20 74 68 65 20 63 6c 69 |cassions| the cli|
|00002eb0| 65 6e 74 20 6d 61 79 20 | 6e 65 65 64 20 74 68 65 |ent may |need the|
|00002ec0| 20 64 61 74 61 20 61 6e | 64 20 69 74 20 68 61 73 | data an|d it has|
|00002ed0| 6e d5 74 20 61 72 72 69 | 76 65 64 20 62 79 20 74 |n.t arri|ved by t|
|00002ee0| 68 65 20 72 65 71 75 65 | 73 74 65 64 20 73 63 68 |he reque|sted sch|
|00002ef0| 65 64 75 6c 65 20 74 69 | 6d 65 2e 20 44 61 74 61 |edule ti|me. Data|
|00002f00| 48 46 69 6e 69 73 68 44 | 61 74 61 20 61 6c 6c 6f |HFinishD|ata allo|
|00002f10| 77 73 20 74 68 65 20 63 | 6c 69 65 6e 74 20 74 6f |ws the c|lient to|
|00002f20| 20 65 69 74 68 65 72 20 | 63 61 6e 63 65 6c 20 61 | either |cancel a|
|00002f30| 20 70 65 6e 64 69 6e 67 | 20 72 65 61 64 20 72 65 | pending| read re|
|00002f40| 71 75 65 73 74 2c 20 6f | 72 20 64 65 6d 61 6e 64 |quest, o|r demand|
|00002f50| 20 74 68 61 74 20 69 74 | 20 62 65 20 66 69 6e 69 | that it| be fini|
|00002f60| 73 68 65 64 20 69 6d 6d | 65 64 69 61 74 65 6c 79 |shed imm|ediately|
|00002f70| 2e 20 54 68 65 20 72 65 | 61 64 20 72 65 71 75 65 |. The re|ad reque|
|00002f80| 73 74 20 69 73 20 69 64 | 65 6e 74 69 66 69 65 64 |st is id|entified|
|00002f90| 20 62 79 20 70 61 73 73 | 65 64 20 74 68 65 20 61 | by pass|ed the a|
|00002fa0| 64 64 72 65 73 73 20 74 | 68 61 74 20 74 68 65 20 |ddress t|hat the |
|00002fb0| 72 65 61 64 20 77 61 73 | 20 74 6f 20 62 65 20 70 |read was| to be p|
|00002fc0| 6c 61 63 65 64 20 69 6e | 74 6f 20 69 6e 20 50 6c |laced in|to in Pl|
|00002fd0| 61 63 65 54 6f 50 75 74 | 44 61 74 61 50 74 72 2e |aceToPut|DataPtr.|
|00002fe0| 20 49 66 20 50 6c 61 63 | 65 54 6f 50 75 74 44 61 | If Plac|eToPutDa|
|00002ff0| 74 61 50 74 72 20 69 73 | 20 73 65 74 20 74 6f 20 |taPtr is| set to |
|00003000| 6e 69 6c 2c 20 74 68 65 | 6e 20 61 6c 6c 20 70 65 |nil, the|n all pe|
|00003010| 6e 64 69 6e 67 20 72 65 | 61 64 73 20 62 79 20 74 |nding re|ads by t|
|00003020| 68 69 73 20 63 6c 69 65 | 6e 74 20 61 72 65 20 65 |his clie|nt are e|
|00003030| 66 66 65 63 74 65 64 2e | 20 20 49 66 20 74 68 65 |ffected.|  If the|
|00003040| 20 72 65 61 64 20 69 73 | 20 74 6f 20 62 65 20 63 | read is| to be c|
|00003050| 61 6e 63 65 6c 65 64 2c | 20 43 61 6e 63 65 6c 20 |anceled,| Cancel |
|00003060| 69 73 20 73 65 74 20 74 | 6f 20 74 72 75 65 2c 20 |is set t|o true, |
|00003070| 6f 74 68 65 72 77 69 73 | 65 20 69 74 20 69 73 20 |otherwis|e it is |
|00003080| 73 65 74 20 74 6f 20 66 | 61 6c 73 65 2e 20 54 68 |set to f|alse. Th|
|00003090| 65 20 63 61 6c 6c 65 72 | 73 20 63 6f 6d 70 6c 65 |e caller|s comple|
|000030a0| 74 69 6f 6e 20 72 6f 75 | 74 69 6e 65 20 28 70 61 |tion rou|tine (pa|
|000030b0| 73 73 65 64 20 69 6e 74 | 6f 20 44 61 74 61 48 53 |ssed int|o DataHS|
|000030c0| 63 68 65 64 75 6c 65 44 | 61 74 61 29 20 6d 75 73 |cheduleD|ata) mus|
|000030d0| 74 20 73 74 69 6c 6c 20 | 62 65 20 63 61 6c 6c 65 |t still |be calle|
|000030e0| 64 20 62 79 20 74 68 65 | 20 44 61 74 61 20 48 61 |d by the| Data Ha|
|000030f0| 6e 64 6c 65 72 2c 20 65 | 76 65 6e 20 69 66 20 44 |ndler, e|ven if D|
|00003100| 61 74 61 48 46 69 6e 69 | 73 68 44 61 74 61 20 69 |ataHFini|shData i|
|00003110| 73 20 63 61 6c 6c 65 64 | 2e 0d 70 61 73 63 61 6c |s called|..pascal|
|00003120| 20 43 6f 6d 70 6f 6e 65 | 6e 74 52 65 73 75 6c 74 | Compone|ntResult|
|00003130| 20 44 61 74 61 48 54 61 | 73 6b 20 28 44 61 74 61 | DataHTa|sk (Data|
|00003140| 48 61 6e 64 6c 65 72 20 | 64 68 29 0d 44 61 74 61 |Handler |dh).Data|
|00003150| 48 54 61 73 6b 20 69 73 | 20 63 61 6c 6c 65 64 20 |HTask is| called |
|00003160| 72 65 67 75 6c 61 72 6c | 79 20 20 62 79 20 63 6c |regularl|y  by cl|
|00003170| 69 65 6e 74 73 20 6f 66 | 20 74 68 65 20 44 61 74 |ients of| the Dat|
|00003180| 61 20 48 61 6e 64 6c 65 | 72 20 74 6f 20 67 69 76 |a Handle|r to giv|
|00003190| 65 20 69 74 20 74 69 6d | 65 20 74 6f 20 77 6f 72 |e it tim|e to wor|
|000031a0| 6b 2e 20 44 75 72 69 6e | 67 20 44 61 74 61 48 54 |k. Durin|g DataHT|
|000031b0| 61 73 6b 2c 20 72 65 61 | 64 20 63 61 6c 6c 73 20 |ask, rea|d calls |
|000031c0| 6d 61 79 20 62 65 20 69 | 73 73 75 65 64 2c 20 61 |may be i|ssued, a|
|000031d0| 6e 64 20 64 61 74 61 20 | 64 65 6c 69 76 65 72 65 |nd data |delivere|
|000031e0| 64 20 74 6f 20 70 65 6e | 64 69 6e 67 20 72 65 61 |d to pen|ding rea|
|000031f0| 64 73 2e 20 42 65 63 61 | 75 73 65 20 69 74 20 69 |ds. Beca|use it i|
|00003200| 73 20 63 61 6c 6c 65 64 | 20 76 65 72 79 20 6f 66 |s called| very of|
|00003210| 74 65 6e 20 64 75 72 69 | 6e 67 20 6e 6f 72 6d 61 |ten duri|ng norma|
|00003220| 6c 20 4d 6f 76 69 65 20 | 70 6c 61 79 62 61 63 6b |l Movie |playback|
|00003230| 2c 20 44 61 74 61 48 54 | 61 73 6b 20 73 68 6f 75 |, DataHT|ask shou|
|00003240| 6c 64 20 62 65 20 66 61 | 73 74 2e 0d 50 72 65 72 |ld be fa|st..Prer|
|00003250| 6f 6c 6c 0d 41 20 51 75 | 69 63 6b 54 69 6d 65 20 |oll.A Qu|ickTime |
|00003260| 6d 6f 76 69 65 20 69 73 | 20 74 79 70 69 63 61 6c |movie is| typical|
|00003270| 6c 79 20 70 72 65 72 6f | 6c 6c 65 64 20 62 65 66 |ly prero|lled bef|
|00003280| 6f 72 65 20 69 74 20 70 | 6c 61 79 65 64 2e 20 44 |ore it p|layed. D|
|00003290| 75 72 69 6e 67 20 74 68 | 69 73 20 74 69 6d 65 20 |uring th|is time |
|000032a0| 69 74 20 61 6c 6c 6f 63 | 61 74 65 73 20 61 6c 6c |it alloc|ates all|
|000032b0| 20 74 68 65 20 72 65 73 | 6f 75 72 63 65 73 20 69 | the res|ources i|
|000032c0| 74 20 6e 65 65 64 20 74 | 6f 20 70 6c 61 79 20 74 |t need t|o play t|
|000032d0| 68 65 20 6d 6f 76 69 65 | 2e 20 49 74 20 61 6c 73 |he movie|. It als|
|000032e0| 6f 20 72 65 61 64 73 20 | 74 68 65 20 64 61 74 61 |o reads |the data|
|000032f0| 20 69 74 20 6e 65 65 64 | 73 20 74 6f 20 73 74 61 | it need|s to sta|
|00003300| 72 74 20 74 68 65 20 6d | 6f 76 69 65 20 70 6c 61 |rt the m|ovie pla|
|00003310| 79 69 6e 67 2e 20 42 65 | 63 61 75 73 65 20 51 75 |ying. Be|cause Qu|
|00003320| 69 63 6b 54 69 6d 65 20 | 6d 6f 76 69 65 20 64 61 |ickTime |movie da|
|00003330| 74 61 20 69 73 20 69 6e | 74 65 72 6c 65 61 76 65 |ta is in|terleave|
|00003340| 64 2c 20 69 66 20 65 61 | 63 68 20 44 61 74 61 20 |d, if ea|ch Data |
|00003350| 48 61 6e 64 6c 65 72 20 | 63 6c 69 65 6e 74 20 77 |Handler |client w|
|00003360| 65 72 65 20 74 6f 20 72 | 65 61 64 20 74 68 65 69 |ere to r|ead thei|
|00003370| 72 20 64 61 74 61 20 77 | 69 74 68 20 69 6d 6d 65 |r data w|ith imme|
|00003380| 64 69 61 74 65 20 72 65 | 71 75 65 73 74 73 2c 20 |diate re|quests, |
|00003390| 73 69 67 6e 69 66 69 63 | 61 6e 74 20 74 69 6d 65 |signific|ant time|
|000033a0| 20 77 6f 75 6c 64 20 62 | 65 20 77 61 73 74 65 64 | would b|e wasted|
|000033b0| 20 73 65 65 6b 69 6e 67 | 20 61 72 6f 75 6e 64 20 | seeking| around |
|000033c0| 74 68 65 20 66 69 6c 65 | 20 66 6f 72 20 74 68 65 |the file| for the|
|000033d0| 20 64 61 74 61 2e 20 49 | 6e 73 74 65 61 64 2c 20 | data. I|nstead, |
|000033e0| 77 68 65 6e 20 61 20 6d | 6f 76 69 65 20 69 73 20 |when a m|ovie is |
|000033f0| 70 72 65 72 6f 6c 6c 65 | 64 20 61 6c 6c 20 74 68 |prerolle|d all th|
|00003400| 65 20 72 65 61 64 20 72 | 65 71 75 65 73 74 73 20 |e read r|equests |
|00003410| 61 72 65 20 71 75 65 75 | 65 64 20 75 70 20 77 69 |are queu|ed up wi|
|00003420| 74 68 20 44 61 74 61 48 | 53 63 68 65 64 75 6c 65 |th DataH|Schedule|
|00003430| 44 61 74 61 20 61 6e 64 | 20 74 68 65 6e 20 61 20 |Data and| then a |
|00003440| 44 61 74 61 48 46 69 6e | 69 73 68 44 61 74 61 20 |DataHFin|ishData |
|00003450| 63 61 6c 6c 73 20 69 73 | 20 69 73 73 75 65 64 20 |calls is| issued |
|00003460| 74 6f 20 66 69 6e 69 73 | 68 20 61 6c 6c 20 74 68 |to finis|h all th|
|00003470| 65 20 72 65 61 64 73 2e | 20 49 6e 20 74 68 69 73 |e reads.| In this|
|00003480| 20 77 61 79 2c 20 74 68 | 65 20 64 61 74 61 20 68 | way, th|e data h|
|00003490| 61 6e 64 6c 65 72 20 63 | 61 6e 20 61 72 72 61 6e |andler c|an arran|
|000034a0| 67 65 20 74 68 65 20 72 | 65 61 64 20 72 65 71 75 |ge the r|ead requ|
|000034b0| 65 73 74 73 20 74 6f 20 | 61 6c 6c 6f 77 20 66 6f |ests to |allow fo|
|000034c0| 72 20 74 68 65 20 6d 6f | 73 74 20 65 66 66 69 63 |r the mo|st effic|
|000034d0| 69 65 6e 74 20 72 65 61 | 64 73 20 66 72 6f 6d 20 |ient rea|ds from |
|000034e0| 74 68 65 20 67 69 76 65 | 6e 20 64 65 76 69 63 65 |the give|n device|
|000034f0| 2e 0d 54 68 65 20 44 61 | 74 61 48 53 63 68 65 64 |..The Da|taHSched|
|00003500| 75 6c 65 44 61 74 61 20 | 63 61 6c 6c 20 69 73 20 |uleData |call is |
|00003510| 70 61 73 73 65 64 20 73 | 6f 6d 65 20 6e 6f 6e 2d |passed s|ome non-|
|00003520| 73 74 61 6e 64 61 72 64 | 20 76 61 6c 75 65 73 20 |standard| values |
|00003530| 74 6f 20 69 6e 64 69 63 | 61 74 65 20 74 68 61 74 |to indic|ate that|
|00003540| 20 61 20 70 72 65 72 6f | 6c 6c 20 69 73 20 6f 63 | a prero|ll is oc|
|00003550| 63 75 72 69 6e 67 2e 20 | 52 65 71 75 65 73 74 73 |curing. |Requests|
|00003560| 20 66 6f 72 20 70 72 65 | 72 6f 6c 6c 20 68 61 76 | for pre|roll hav|
|00003570| 65 20 74 68 65 20 73 63 | 61 6c 65 20 66 69 65 6c |e the sc|ale fiel|
|00003580| 64 20 6f 66 20 74 68 65 | 20 54 69 6d 65 52 65 63 |d of the| TimeRec|
|00003590| 6f 72 64 20 73 65 74 20 | 74 6f 20 2d 31 2e 20 54 |ord set |to -1. T|
|000035a0| 68 69 73 20 69 6e 64 69 | 63 61 74 65 73 20 74 68 |his indi|cates th|
|000035b0| 61 74 20 74 68 65 20 64 | 61 74 61 20 73 68 6f 75 |at the d|ata shou|
|000035c0| 6c 64 20 62 65 20 64 65 | 6c 69 76 65 64 20 61 74 |ld be de|lived at|
|000035d0| 20 61 6e 20 69 6e 66 69 | 6e 69 74 65 20 74 69 6d | an infi|nite tim|
|000035e0| 65 20 69 6e 20 74 68 65 | 20 66 75 74 75 72 65 2e |e in the| future.|
|000035f0| 20 41 20 44 61 74 61 48 | 46 69 6e 69 73 68 44 61 | A DataH|FinishDa|
|00003600| 74 61 20 63 61 6c 6c 20 | 77 69 6c 6c 20 62 65 20 |ta call |will be |
|00003610| 69 73 73 75 65 64 20 61 | 66 74 65 72 20 61 6c 6c |issued a|fter all|
|00003620| 20 72 65 61 64 73 20 68 | 61 76 65 20 62 65 65 6e | reads h|ave been|
|00003630| 20 71 75 65 75 65 64 2e | 0d 44 75 72 69 6e 67 20 | queued.|.During |
|00003640| 70 72 65 72 6f 6c 6c 20 | 44 61 74 61 48 53 63 68 |preroll |DataHSch|
|00003650| 65 64 75 6c 65 44 61 74 | 61 20 69 73 20 61 6c 73 |eduleDat|a is als|
|00003660| 6f 20 63 61 6c 6c 65 64 | 20 69 6e 20 61 6e 6f 74 |o called| in anot|
|00003670| 68 65 72 20 77 61 79 2e | 20 54 68 65 20 d2 73 63 |her way.| The .sc|
|00003680| 61 6c 65 d3 20 66 69 65 | 6c 64 20 69 73 20 73 65 |ale. fie|ld is se|
|00003690| 74 20 74 6f 20 61 20 63 | 6f 72 72 65 63 74 20 76 |t to a c|orrect v|
|000036a0| 61 6c 75 65 2c 20 62 75 | 74 20 74 68 65 20 d2 76 |alue, bu|t the .v|
|000036b0| 61 6c 75 65 d3 20 66 69 | 65 6c 64 20 69 73 20 6e |alue. fi|eld is n|
|000036c0| 65 67 61 74 65 64 20 66 | 72 6f 6d 20 74 68 65 20 |egated f|rom the |
|000036d0| 61 63 74 75 61 6c 20 64 | 65 73 69 72 65 64 20 74 |actual d|esired t|
|000036e0| 69 6d 65 2e 20 54 68 69 | 73 20 69 6e 64 69 63 61 |ime. Thi|s indica|
|000036f0| 74 65 73 20 74 68 61 74 | 20 74 68 65 20 72 65 71 |tes that| the req|
|00003700| 75 65 73 74 20 69 73 20 | 6f 70 74 69 6f 6e 61 6c |uest is |optional|
|00003710| 20 77 68 65 6e 20 74 68 | 65 20 44 61 74 61 48 46 | when th|e DataHF|
|00003720| 69 6e 69 73 68 20 63 61 | 6c 6c 20 69 73 20 73 65 |inish ca|ll is se|
|00003730| 6e 74 2e 20 49 66 20 74 | 68 65 20 62 6c 6f 63 6b |nt. If t|he block|
|00003740| 20 69 73 20 63 6f 6e 74 | 69 67 75 6f 75 73 20 77 | is cont|iguous w|
|00003750| 69 74 68 20 74 68 65 20 | 72 65 6d 61 69 6e 69 6e |ith the |remainin|
|00003760| 67 20 72 65 71 75 69 72 | 65 64 20 72 65 71 75 65 |g requir|ed reque|
|00003770| 73 74 73 20 28 69 2e 65 | 2e 20 65 61 73 69 6c 79 |sts (i.e|. easily|
|00003780| 20 61 63 63 65 73 73 65 | 64 29 20 2c 20 69 74 20 | accesse|d) , it |
|00003790| 73 68 6f 75 6c 64 20 62 | 65 20 64 65 6c 69 76 65 |should b|e delive|
|000037a0| 72 65 64 2e 20 4f 74 68 | 65 72 77 69 73 65 2c 20 |red. Oth|erwise, |
|000037b0| 74 68 65 20 64 61 74 61 | 20 73 68 6f 75 6c 64 20 |the data| should |
|000037c0| 62 65 20 64 65 6c 69 76 | 65 72 65 64 20 61 74 20 |be deliv|ered at |
|000037d0| 74 68 65 20 74 69 6d 65 | 20 6f 62 74 61 69 6e 65 |the time| obtaine|
|000037e0| 64 20 62 79 20 6e 65 67 | 61 74 69 6e 67 20 74 68 |d by neg|ating th|
|000037f0| 65 20 d2 76 61 6c 75 65 | d3 20 66 69 65 6c 64 2e |e .value|. field.|
|00003800| 20 53 69 6e 63 65 20 6d | 6f 76 69 65 73 20 61 72 | Since m|ovies ar|
|00003810| 65 20 74 79 70 69 63 61 | 6c 6c 79 20 70 72 65 72 |e typica|lly prer|
|00003820| 6f 6c 6c 65 64 20 77 68 | 65 6e 20 74 68 65 69 72 |olled wh|en their|
|00003830| 20 72 61 74 65 20 69 73 | 20 7a 65 72 6f 2c 20 69 | rate is| zero, i|
|00003840| 74 20 69 73 20 69 6d 70 | 6f 73 73 69 62 6c 65 20 |t is imp|ossible |
|00003850| 74 6f 20 6b 6e 6f 77 20 | 77 68 65 6e 20 74 68 65 |to know |when the|
|00003860| 20 64 61 74 61 20 73 68 | 6f 75 6c 64 20 62 65 20 | data sh|ould be |
|00003870| 64 65 6c 69 76 65 72 65 | 64 20 75 6e 74 69 6c 20 |delivere|d until |
|00003880| 74 68 65 20 6d 6f 76 69 | 65 d5 73 20 72 61 74 65 |the movi|e.s rate|
|00003890| 20 63 68 61 6e 67 65 73 | 20 74 6f 20 61 20 6e 6f | changes| to a no|
|000038a0| 6e 2d 7a 65 72 6f 20 76 | 61 6c 75 65 2e 20 59 6f |n-zero v|alue. Yo|
|000038b0| 75 20 63 61 6e 20 65 61 | 73 69 6c 79 20 6b 6e 6f |u can ea|sily kno|
|000038c0| 77 20 77 68 65 6e 20 61 | 20 6d 6f 76 69 65 d5 73 |w when a| movie.s|
|000038d0| 20 72 61 74 65 20 63 68 | 61 6e 67 65 73 20 62 79 | rate ch|anges by|
|000038e0| 20 69 6e 73 74 61 6c 6c | 69 6e 67 20 61 20 51 75 | install|ing a Qu|
|000038f0| 69 63 6b 54 69 6d 65 20 | 43 61 6c 6c 42 61 63 6b |ickTime |CallBack|
|00003900| 20 74 6f 20 6e 6f 74 69 | 66 79 20 79 6f 75 72 20 | to noti|fy your |
|00003910| 64 61 74 61 20 68 61 6e | 64 6c 65 72 20 6f 66 20 |data han|dler of |
|00003920| 72 61 74 65 20 63 68 61 | 6e 67 65 73 2e 0d 43 61 |rate cha|nges..Ca|
|00003930| 63 68 65 20 4d 61 6e 61 | 67 65 6d 65 6e 74 0d 70 |che Mana|gement.p|
|00003940| 61 73 63 61 6c 20 43 6f | 6d 70 6f 6e 65 6e 74 52 |ascal Co|mponentR|
|00003950| 65 73 75 6c 74 20 44 61 | 74 61 48 46 6c 75 73 68 |esult Da|taHFlush|
|00003960| 43 61 63 68 65 20 28 44 | 61 74 61 48 61 6e 64 6c |Cache (D|ataHandl|
|00003970| 65 72 20 64 68 29 0d 54 | 68 65 20 44 61 74 61 48 |er dh).T|he DataH|
|00003980| 46 6c 75 73 68 43 61 63 | 68 65 20 63 61 6c 6c 20 |FlushCac|he call |
|00003990| 69 73 20 69 73 73 75 65 | 64 20 74 6f 20 6d 61 6b |is issue|d to mak|
|000039a0| 65 20 74 68 65 20 44 61 | 74 61 20 48 61 6e 64 6c |e the Da|ta Handl|
|000039b0| 65 72 20 69 6e 76 61 6c | 69 64 61 74 65 20 74 68 |er inval|idate th|
|000039c0| 65 20 63 6f 6e 74 65 6e | 74 73 20 6f 66 20 61 6e |e conten|ts of an|
|000039d0| 79 20 72 65 61 64 20 62 | 75 66 66 65 72 73 20 69 |y read b|uffers i|
|000039e0| 74 20 6d 61 79 20 68 61 | 76 65 20 63 75 72 72 65 |t may ha|ve curre|
|000039f0| 6e 74 6c 79 20 63 61 63 | 68 65 64 2e 20 54 68 69 |ntly cac|hed. Thi|
|00003a00| 73 20 69 73 20 75 73 65 | 66 75 6c 20 69 66 20 61 |s is use|ful if a|
|00003a10| 20 63 6c 69 65 6e 74 20 | 68 61 73 20 63 68 61 6e | client |has chan|
|00003a20| 67 65 64 20 74 68 65 20 | 63 6f 6e 74 65 6e 74 73 |ged the |contents|
|00003a30| 20 6f 66 20 74 68 65 20 | 64 61 74 61 20 72 65 66 | of the |data ref|
|00003a40| 65 72 65 6e 63 65 20 69 | 6e 20 73 6f 6d 65 20 77 |erence i|n some w|
|00003a50| 61 79 20 65 78 74 65 72 | 6e 61 6c 20 74 6f 20 74 |ay exter|nal to t|
|00003a60| 68 65 20 44 61 74 61 20 | 48 61 6e 64 6c 65 72 2e |he Data |Handler.|
|00003a70| 0d 20 0d 70 61 73 63 61 | 6c 20 43 6f 6d 70 6f 6e |. .pasca|l Compon|
|00003a80| 65 6e 74 52 65 73 75 6c | 74 20 44 61 74 61 48 46 |entResul|t DataHF|
|00003a90| 6c 75 73 68 44 61 74 61 | 20 28 44 61 74 61 48 61 |lushData| (DataHa|
|00003aa0| 6e 64 6c 65 72 20 64 68 | 29 0d 44 61 74 61 48 46 |ndler dh|).DataHF|
|00003ab0| 6c 75 73 68 44 61 74 61 | 20 6d 61 79 20 62 65 20 |lushData| may be |
|00003ac0| 69 73 73 75 65 64 20 61 | 66 74 65 72 20 61 20 77 |issued a|fter a w|
|00003ad0| 72 69 74 65 20 63 6f 6d | 6d 61 6e 64 2e 20 49 74 |rite com|mand. It|
|00003ae0| 20 63 61 75 73 65 73 20 | 61 6e 79 20 64 61 74 61 | causes |any data|
|00003af0| 20 69 6e 20 77 72 69 74 | 65 20 62 75 66 66 65 72 | in writ|e buffer|
|00003b00| 73 20 74 6f 20 62 65 20 | 66 6c 75 73 68 65 64 20 |s to be |flushed |
|00003b10| 74 6f 20 64 69 73 6b 2e | 20 49 74 20 69 73 20 72 |to disk.| It is r|
|00003b20| 6f 75 67 68 6c 79 20 65 | 71 75 69 76 61 6c 65 6e |oughly e|quivalen|
|00003b30| 74 20 74 6f 20 74 68 65 | 20 66 69 6c 65 20 4d 61 |t to the| file Ma|
|00003b40| 6e 61 67 65 72 d5 73 20 | 50 42 46 6c 75 73 68 46 |nager.s |PBFlushF|
|00003b50| 69 6c 65 20 72 6f 75 74 | 69 6e 65 2e 0d 4d 6f 76 |ile rout|ine..Mov|
|00003b60| 69 65 20 43 61 70 74 75 | 72 65 0d 49 6e 20 74 68 |ie Captu|re.In th|
|00003b70| 65 20 70 61 73 74 2c 20 | 77 68 65 6e 20 51 75 69 |e past, |when Qui|
|00003b80| 63 6b 54 69 6d 65 d5 73 | 20 53 65 71 75 65 6e 63 |ckTime.s| Sequenc|
|00003b90| 65 20 47 72 61 62 62 65 | 72 20 63 6f 6d 70 6f 6e |e Grabbe|r compon|
|00003ba0| 65 6e 74 20 63 61 70 74 | 75 72 65 64 20 61 20 6d |ent capt|ured a m|
|00003bb0| 6f 76 69 65 2c 20 69 74 | 20 77 6f 75 6c 64 20 64 |ovie, it| would d|
|00003bc0| 6f 20 73 6f 20 62 79 20 | 75 73 69 6e 67 20 74 68 |o so by |using th|
|00003bd0| 65 20 46 69 6c 65 20 53 | 79 73 74 65 6d 20 64 69 |e File S|ystem di|
|00003be0| 72 65 63 74 6c 79 20 74 | 6f 20 63 72 65 61 74 65 |rectly t|o create|
|00003bf0| 20 61 6e 64 20 61 63 63 | 65 73 73 20 74 68 65 20 | and acc|ess the |
|00003c00| 6d 6f 76 69 65 20 66 69 | 6c 65 2e 20 54 6f 20 65 |movie fi|le. To e|
|00003c10| 6e 61 62 6c 65 20 67 72 | 65 61 74 65 72 20 66 6c |nable gr|eater fl|
|00003c20| 65 78 69 62 69 6c 69 74 | 79 2c 20 74 68 65 20 53 |exibilit|y, the S|
|00003c30| 65 71 75 65 6e 63 65 20 | 47 72 61 62 62 65 72 20 |equence |Grabber |
|00003c40| 6e 6f 77 20 75 73 65 73 | 20 61 20 6e 65 77 20 44 |now uses| a new D|
|00003c50| 61 74 61 20 48 61 6e 64 | 6c 65 72 20 74 6f 20 63 |ata Hand|ler to c|
|00003c60| 61 70 74 75 72 65 20 74 | 68 65 20 6d 6f 76 69 65 |apture t|he movie|
|00003c70| 2e 20 54 68 65 20 64 61 | 74 61 20 68 61 6e 64 6c |. The da|ta handl|
|00003c80| 65 72 20 73 75 70 70 6f | 72 74 73 20 61 20 67 72 |er suppo|rts a gr|
|00003c90| 6f 75 70 20 6f 66 20 6e | 65 77 20 41 50 49 20 63 |oup of n|ew API c|
|00003ca0| 61 6c 6c 73 20 74 6f 20 | 61 6c 6c 6f 77 20 74 68 |alls to |allow th|
|00003cb0| 69 73 20 66 75 6e 63 74 | 69 6f 6e 61 6c 69 74 79 |is funct|ionality|
|00003cc0| 2e 20 54 68 65 73 65 20 | 63 61 6c 6c 73 20 61 72 |. These |calls ar|
|00003cd0| 65 20 64 6f 63 75 6d 65 | 6e 74 65 64 20 62 65 6c |e docume|nted bel|
|00003ce0| 6f 77 2e 0d 70 61 73 63 | 61 6c 20 43 6f 6d 70 6f |ow..pasc|al Compo|
|00003cf0| 6e 65 6e 74 52 65 73 75 | 6c 74 20 44 61 74 61 48 |nentResu|lt DataH|
|00003d00| 47 65 74 46 69 6c 65 53 | 69 7a 65 20 28 44 61 74 |GetFileS|ize (Dat|
|00003d10| 61 48 61 6e 64 6c 65 72 | 20 64 68 2c 20 6c 6f 6e |aHandler| dh, lon|
|00003d20| 67 20 2a 66 69 6c 65 53 | 69 7a 65 29 0d 44 61 74 |g *fileS|ize).Dat|
|00003d30| 61 48 47 65 74 46 69 6c | 65 20 73 69 7a 65 20 72 |aHGetFil|e size r|
|00003d40| 65 74 75 72 6e 73 20 74 | 68 65 20 73 69 7a 65 2c |eturns t|he size,|
|00003d50| 20 69 6e 20 62 79 74 65 | 73 2c 20 6f 66 20 74 68 | in byte|s, of th|
|00003d60| 65 20 64 61 74 61 20 72 | 65 66 65 72 65 6e 63 65 |e data r|eference|
|00003d70| 64 20 62 79 20 74 68 65 | 20 63 75 72 72 65 6e 74 |d by the| current|
|00003d80| 20 64 61 74 61 20 72 65 | 66 65 72 65 6e 63 65 2e | data re|ference.|
|00003d90| 20 54 68 69 73 20 69 73 | 20 74 68 65 20 65 71 75 | This is| the equ|
|00003da0| 69 76 61 6c 65 6e 74 20 | 6f 66 20 74 68 65 20 46 |ivalent |of the F|
|00003db0| 69 6c 65 20 53 79 73 74 | 65 6d d5 73 20 47 65 74 |ile Syst|em.s Get|
|00003dc0| 45 4f 46 20 66 75 6e 63 | 74 69 6f 6e 2e 0d 70 61 |EOF func|tion..pa|
|00003dd0| 73 63 61 6c 20 43 6f 6d | 70 6f 6e 65 6e 74 52 65 |scal Com|ponentRe|
|00003de0| 73 75 6c 74 20 44 61 74 | 61 48 53 65 74 46 69 6c |sult Dat|aHSetFil|
|00003df0| 65 53 69 7a 65 20 28 44 | 61 74 61 48 61 6e 64 6c |eSize (D|ataHandl|
|00003e00| 65 72 20 64 68 2c 20 6c | 6f 6e 67 20 66 69 6c 65 |er dh, l|ong file|
|00003e10| 53 69 7a 65 29 0d 44 61 | 74 61 48 53 65 74 46 69 |Size).Da|taHSetFi|
|00003e20| 6c 65 53 69 7a 65 20 73 | 65 74 73 20 74 68 65 20 |leSize s|ets the |
|00003e30| 73 69 7a 65 20 6f 66 20 | 74 68 65 20 64 61 74 61 |size of |the data|
|00003e40| 20 72 65 66 65 72 65 6e | 63 65 64 20 62 79 20 74 | referen|ced by t|
|00003e50| 68 65 20 63 75 72 72 65 | 6e 74 20 64 61 74 61 20 |he curre|nt data |
|00003e60| 72 65 66 65 72 65 6e 63 | 65 2e 20 54 68 69 73 20 |referenc|e. This |
|00003e70| 69 73 20 74 68 65 20 65 | 71 75 69 76 61 6c 65 6e |is the e|quivalen|
|00003e80| 74 20 6f 66 20 74 68 65 | 20 46 69 6c 65 20 53 79 |t of the| File Sy|
|00003e90| 73 74 65 6d d5 73 20 53 | 65 74 45 4f 46 20 66 75 |stem.s S|etEOF fu|
|00003ea0| 6e 63 74 69 6f 6e 2e 0d | 70 61 73 63 61 6c 20 43 |nction..|pascal C|
|00003eb0| 6f 6d 70 6f 6e 65 6e 74 | 52 65 73 75 6c 74 20 44 |omponent|Result D|
|00003ec0| 61 74 61 48 43 72 65 61 | 74 65 46 69 6c 65 20 28 |ataHCrea|teFile (|
|00003ed0| 44 61 74 61 48 61 6e 64 | 6c 65 72 20 64 68 2c 20 |DataHand|ler dh, |
|00003ee0| 4f 53 54 79 70 65 20 63 | 72 65 61 74 6f 72 2c 20 |OSType c|reator, |
|00003ef0| 42 6f 6f 6c 65 61 6e 20 | 64 65 6c 65 74 65 45 78 |Boolean |deleteEx|
|00003f00| 69 73 74 69 6e 67 29 0d | 44 61 74 61 48 43 72 65 |isting).|DataHCre|
|00003f10| 61 74 65 46 69 6c 65 20 | 63 72 65 61 74 65 73 20 |ateFile |creates |
|00003f20| 61 20 6e 65 77 20 64 61 | 74 61 20 63 6f 6e 74 61 |a new da|ta conta|
|00003f30| 69 6e 65 72 20 61 73 20 | 73 70 65 63 69 66 69 65 |iner as |specifie|
|00003f40| 64 20 62 79 20 74 68 65 | 20 63 75 72 72 65 6e 74 |d by the| current|
|00003f50| 20 64 61 74 61 20 72 65 | 66 65 72 65 6e 63 65 2e | data re|ference.|
|00003f60| 20 49 74 73 20 63 72 65 | 61 74 6f 72 20 74 79 70 | Its cre|ator typ|
|00003f70| 65 2c 20 69 66 20 61 70 | 70 72 6f 70 72 69 61 74 |e, if ap|propriat|
|00003f80| 65 20 77 69 6c 6c 20 62 | 65 20 73 65 74 20 74 6f |e will b|e set to|
|00003f90| 20 d2 63 72 65 61 74 6f | 72 d3 2e 20 50 61 73 73 | .creato|r.. Pass|
|00003fa0| 69 6e 67 20 30 20 66 6f | 72 20 63 72 65 61 74 6f |ing 0 fo|r creato|
|00003fb0| 72 20 6d 65 61 6e 73 20 | 74 68 61 74 20 61 20 72 |r means |that a r|
|00003fc0| 65 61 73 6f 6e 61 62 6c | 65 20 64 65 66 61 75 6c |easonabl|e defaul|
|00003fd0| 74 20 28 d4 54 56 4f 44 | d5 29 20 73 68 6f 75 6c |t (.TVOD|.) shoul|
|00003fe0| 64 20 62 65 20 63 68 6f | 73 65 6e 2e 20 49 66 20 |d be cho|sen. If |
|00003ff0| d2 64 65 6c 65 74 65 45 | 78 69 73 74 69 6e 67 d3 |.deleteE|xisting.|
|00004000| 20 69 73 20 73 65 74 2c | 20 61 6e 79 20 65 78 69 | is set,| any exi|
|00004010| 73 74 69 6e 67 20 64 61 | 74 61 20 72 65 66 65 72 |sting da|ta refer|
|00004020| 65 6e 63 65 64 20 62 79 | 20 74 68 65 20 63 75 72 |enced by| the cur|
|00004030| 72 65 6e 74 20 64 61 74 | 61 20 72 65 66 65 72 65 |rent dat|a refere|
|00004040| 6e 63 65 20 73 68 6f 75 | 6c 64 20 62 65 20 64 65 |nce shou|ld be de|
|00004050| 6c 65 74 65 64 2c 20 62 | 65 66 6f 72 65 20 74 68 |leted, b|efore th|
|00004060| 65 20 6e 65 77 20 64 61 | 74 61 20 63 6f 6e 74 61 |e new da|ta conta|
|00004070| 69 6e 65 72 20 69 73 20 | 63 72 65 61 74 65 64 2e |iner is |created.|
|00004080| 20 49 66 20 64 65 6c 65 | 74 65 45 78 69 73 74 69 | If dele|teExisti|
|00004090| 6e 67 20 69 73 20 66 61 | 6c 73 65 2c 20 61 6e 64 |ng is fa|lse, and|
|000040a0| 20 74 68 65 72 65 20 61 | 6c 72 65 61 64 79 20 65 | there a|lready e|
|000040b0| 78 69 73 74 73 20 61 20 | 64 61 74 61 20 63 6f 6e |xists a |data con|
|000040c0| 74 61 69 6e 65 72 20 72 | 65 66 65 72 65 6e 63 65 |tainer r|eference|
|000040d0| 64 20 62 79 20 74 68 65 | 20 63 75 72 72 65 6e 74 |d by the| current|
|000040e0| 20 64 61 74 61 20 72 65 | 66 65 72 65 6e 63 65 2c | data re|ference,|
|000040f0| 20 69 74 20 73 68 6f 75 | 6c 64 20 62 65 20 6c 65 | it shou|ld be le|
|00004100| 66 74 20 61 73 20 69 73 | 2c 20 61 6e 64 20 6e 6f |ft as is|, and no|
|00004110| 45 72 72 20 73 68 6f 75 | 6c 64 20 62 65 20 72 65 |Err shou|ld be re|
|00004120| 74 75 72 6e 65 64 2e 0d | 70 61 73 63 61 6c 20 43 |turned..|pascal C|
|00004130| 6f 6d 70 6f 6e 65 6e 74 | 52 65 73 75 6c 74 20 44 |omponent|Result D|
|00004140| 61 74 61 48 47 65 74 50 | 72 65 66 65 72 72 65 64 |ataHGetP|referred|
|00004150| 42 6c 6f 63 6b 53 69 7a | 65 20 28 44 61 74 61 48 |BlockSiz|e (DataH|
|00004160| 61 6e 64 6c 65 72 20 64 | 68 2c 20 6c 6f 6e 67 20 |andler d|h, long |
|00004170| 2a 62 6c 6f 63 6b 53 69 | 7a 65 29 0d 44 69 66 66 |*blockSi|ze).Diff|
|00004180| 65 72 65 6e 74 20 64 65 | 76 69 63 65 73 20 75 73 |erent de|vices us|
|00004190| 65 20 64 69 66 66 65 72 | 65 6e 74 20 62 6c 6f 63 |e differ|ent bloc|
|000041a0| 6b 20 73 69 7a 65 73 20 | 66 6f 72 20 69 2f 6f 2e |k sizes |for i/o.|
|000041b0| 20 44 61 74 61 48 47 65 | 74 50 72 65 66 65 72 72 | DataHGe|tPreferr|
|000041c0| 65 64 42 6c 6f 63 6b 53 | 69 7a 65 20 61 6c 6c 6f |edBlockS|ize allo|
|000041d0| 77 73 20 79 6f 75 72 20 | 64 61 74 61 20 68 61 6e |ws your |data han|
|000041e0| 64 6c 65 72 20 74 6f 20 | 72 65 74 75 72 6e 20 74 |dler to |return t|
|000041f0| 68 65 20 73 69 7a 65 20 | 62 6c 6f 63 6b 73 20 69 |he size |blocks i|
|00004200| 74 20 70 72 65 66 65 72 | 73 20 74 6f 20 77 6f 72 |t prefer|s to wor|
|00004210| 6b 20 77 69 74 68 2e 20 | 54 68 65 72 65 20 69 73 |k with. |There is|
|00004220| 20 6e 6f 20 67 75 61 72 | 61 6e 74 65 65 20 74 68 | no guar|antee th|
|00004230| 61 74 20 72 65 61 64 20 | 6f 72 20 77 72 69 74 65 |at read |or write|
|00004240| 20 72 65 71 75 65 73 74 | 73 20 77 69 6c 6c 20 62 | request|s will b|
|00004250| 65 20 6f 66 20 74 68 69 | 73 20 62 6c 6f 63 6b 20 |e of thi|s block |
|00004260| 73 69 7a 65 2c 20 6f 72 | 20 61 20 6d 75 6c 74 69 |size, or| a multi|
|00004270| 70 6c 65 20 6f 66 20 74 | 68 69 73 20 62 6c 6f 63 |ple of t|his bloc|
|00004280| 6b 20 73 69 7a 65 2c 20 | 62 75 74 20 73 6f 6d 65 |k size, |but some|
|00004290| 20 63 6c 69 65 6e 74 73 | 20 6d 61 79 20 6f 70 74 | clients| may opt|
|000042a0| 69 6d 69 7a 65 20 66 6f | 72 20 74 68 69 73 2e 0d |imize fo|r this..|
|000042b0| 70 61 73 63 61 6c 20 43 | 6f 6d 70 6f 6e 65 6e 74 |pascal C|omponent|
|000042c0| 52 65 73 75 6c 74 20 44 | 61 74 61 48 47 65 74 46 |Result D|ataHGetF|
|000042d0| 72 65 65 53 70 61 63 65 | 20 28 44 61 74 61 48 61 |reeSpace| (DataHa|
|000042e0| 6e 64 6c 65 72 20 64 68 | 2c 20 75 6e 73 69 67 6e |ndler dh|, unsign|
|000042f0| 65 64 20 6c 6f 6e 67 20 | 2a 66 72 65 65 53 69 7a |ed long |*freeSiz|
|00004300| 65 29 0d 44 61 74 61 48 | 47 65 74 46 72 65 65 53 |e).DataH|GetFreeS|
|00004310| 70 61 63 65 20 72 65 74 | 75 72 6e 73 20 74 68 65 |pace ret|urns the|
|00004320| 20 6e 75 6d 62 65 72 20 | 6f 66 20 66 72 65 65 20 | number |of free |
|00004330| 73 74 6f 72 61 67 65 20 | 62 79 74 65 73 20 6f 6e |storage |bytes on|
|00004340| 20 74 68 65 20 64 65 76 | 69 63 65 20 74 68 61 74 | the dev|ice that|
|00004350| 20 69 73 20 72 65 66 65 | 72 72 65 64 20 74 6f 20 | is refe|rred to |
|00004360| 62 79 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 64 |by the c|urrent d|
|00004370| 61 74 61 20 72 65 66 65 | 72 65 6e 63 65 2e 0d 70 |ata refe|rence..p|
|00004380| 61 73 63 61 6c 20 43 6f | 6d 70 6f 6e 65 6e 74 52 |ascal Co|mponentR|
|00004390| 65 73 75 6c 74 20 44 61 | 74 61 48 50 72 65 65 78 |esult Da|taHPreex|
|000043a0| 74 65 6e 64 20 28 44 61 | 74 61 48 61 6e 64 6c 65 |tend (Da|taHandle|
|000043b0| 72 20 64 68 2c 20 6c 6f | 6e 67 20 6d 61 78 54 6f |r dh, lo|ng maxTo|
|000043c0| 41 64 64 2c 20 6c 6f 6e | 67 20 2a 73 70 61 63 65 |Add, lon|g *space|
|000043d0| 41 64 64 65 64 29 0d 44 | 61 74 61 48 50 72 65 65 |Added).D|ataHPree|
|000043e0| 78 74 65 6e 64 20 69 73 | 20 75 73 65 64 20 74 6f |xtend is| used to|
|000043f0| 20 61 6c 6c 6f 63 61 74 | 65 20 73 70 61 63 65 20 | allocat|e space |
|00004400| 66 6f 72 20 61 20 66 69 | 6c 65 2c 20 62 65 66 6f |for a fi|le, befo|
|00004410| 72 65 20 74 68 65 20 66 | 69 6c 65 20 69 73 20 74 |re the f|ile is t|
|00004420| 6f 20 62 65 20 75 73 65 | 64 2e 20 54 68 69 73 20 |o be use|d. This |
|00004430| 69 73 20 75 73 65 64 20 | 62 79 20 74 68 65 20 53 |is used |by the S|
|00004440| 65 71 75 65 6e 63 65 20 | 47 72 61 62 62 65 72 20 |equence |Grabber |
|00004450| 73 6f 20 74 68 61 74 20 | 61 20 66 69 6c 65 20 63 |so that |a file c|
|00004460| 61 6e 20 62 65 20 65 78 | 74 65 6e 64 65 64 20 74 |an be ex|tended t|
|00004470| 6f 20 61 20 6c 61 72 67 | 65 20 73 69 7a 65 20 62 |o a larg|e size b|
|00004480| 65 66 6f 72 65 20 63 61 | 70 74 75 72 65 20 62 65 |efore ca|pture be|
|00004490| 67 69 6e 73 2c 20 73 6f | 20 74 68 61 74 20 6e 6f |gins, so| that no|
|000044a0| 20 74 69 6d 65 20 69 73 | 20 73 70 65 6e 74 20 69 | time is| spent i|
|000044b0| 6e 20 66 69 6c 65 20 73 | 79 73 74 65 6d 20 61 6c |n file s|ystem al|
|000044c0| 6c 6f 63 61 74 69 6f 6e | 73 20 64 75 72 69 6e 67 |location|s during|
|000044d0| 20 63 61 70 74 75 72 65 | 2e 20 49 74 20 70 61 73 | capture|. It pas|
|000044e0| 73 65 73 20 d2 6d 61 78 | 54 6f 41 64 64 d3 20 74 |ses .max|ToAdd. t|
|000044f0| 6f 20 72 65 71 75 65 73 | 74 20 74 68 61 74 20 74 |o reques|t that t|
|00004500| 68 65 20 64 61 74 61 20 | 63 6f 6e 74 61 69 6e 65 |he data |containe|
|00004510| 72 20 72 65 66 65 72 65 | 6e 63 65 20 62 79 20 74 |r refere|nce by t|
|00004520| 68 65 20 63 75 72 72 65 | 6e 74 20 64 61 74 61 20 |he curre|nt data |
|00004530| 72 65 66 65 72 65 6e 63 | 65 20 62 65 20 65 78 74 |referenc|e be ext|
|00004540| 65 6e 64 65 64 20 62 79 | 20 74 68 65 20 67 69 76 |ended by| the giv|
|00004550| 65 6e 20 6e 75 6d 62 65 | 72 20 6f 66 20 62 79 74 |en numbe|r of byt|
|00004560| 65 73 2e 20 50 61 73 73 | 69 6e 67 20 30 20 69 6d |es. Pass|ing 0 im|
|00004570| 70 6c 69 65 73 20 74 68 | 61 74 20 74 68 65 20 6d |plies th|at the m|
|00004580| 6f 73 74 20 70 6f 73 73 | 69 62 6c 65 20 62 79 74 |ost poss|ible byt|
|00004590| 65 73 20 73 68 6f 75 6c | 64 20 62 65 20 61 6c 6c |es shoul|d be all|
|000045a0| 6f 63 61 74 65 64 2e 20 | 54 68 65 20 61 63 74 75 |ocated. |The actu|
|000045b0| 61 6c 20 6e 75 6d 62 65 | 72 20 6f 66 20 62 79 74 |al numbe|r of byt|
|000045c0| 65 73 20 61 6c 6c 6f 63 | 61 74 65 64 20 69 73 20 |es alloc|ated is |
|000045d0| 72 65 74 75 72 6e 65 64 | 20 69 6e 20 d2 73 70 61 |returned| in .spa|
|000045e0| 63 65 41 64 64 65 64 d3 | 2e 20 54 68 69 73 20 63 |ceAdded.|. This c|
|000045f0| 61 6c 6c 20 69 73 20 72 | 6f 75 67 68 6c 79 20 74 |all is r|oughly t|
|00004600| 68 65 20 65 71 75 69 76 | 61 6c 65 6e 74 20 6f 66 |he equiv|alent of|
|00004610| 20 74 68 65 20 46 69 6c | 65 20 53 79 73 74 65 6d | the Fil|e System|
|00004620| d5 73 20 50 42 41 6c 6c | 6f 63 43 6f 6e 74 69 67 |.s PBAll|ocContig|
|00004630| 20 66 75 6e 63 74 69 6f | 6e 2e 0d 70 61 73 63 61 | functio|n..pasca|
|00004640| 6c 20 43 6f 6d 70 6f 6e | 65 6e 74 52 65 73 75 6c |l Compon|entResul|
|00004650| 74 20 44 61 74 61 48 57 | 72 69 74 65 20 28 44 61 |t DataHW|rite (Da|
|00004660| 74 61 48 61 6e 64 6c 65 | 72 20 64 68 2c 20 50 74 |taHandle|r dh, Pt|
|00004670| 72 20 64 61 74 61 2c 20 | 6c 6f 6e 67 20 6f 66 66 |r data, |long off|
|00004680| 73 65 74 2c 20 6c 6f 6e | 67 20 73 69 7a 65 2c 20 |set, lon|g size, |
|00004690| 44 48 43 6f 6d 70 6c 65 | 74 65 50 72 6f 63 20 63 |DHComple|teProc c|
|000046a0| 6f 6d 70 6c 65 74 69 6f | 6e 2c 20 6c 6f 6e 67 20 |ompletio|n, long |
|000046b0| 72 65 66 43 6f 6e 29 0d | 44 61 74 61 48 57 72 69 |refCon).|DataHWri|
|000046c0| 74 65 20 61 6c 6c 6f 77 | 73 20 64 61 74 61 20 74 |te allow|s data t|
|000046d0| 6f 20 62 65 20 77 72 69 | 74 74 65 6e 20 74 6f 20 |o be wri|tten to |
|000046e0| 61 6e 79 20 70 6f 69 6e | 74 20 69 6e 20 61 20 66 |any poin|t in a f|
|000046f0| 69 6c 65 2e 20 54 68 65 | 20 64 61 74 61 20 6d 61 |ile. The| data ma|
|00004700| 79 20 62 65 20 77 72 69 | 74 74 65 6e 20 65 69 74 |y be wri|tten eit|
|00004710| 68 65 72 20 73 79 6e 63 | 68 72 6f 6e 6f 75 73 6c |her sync|hronousl|
|00004720| 79 20 6f 72 20 61 73 79 | 6e 63 68 72 6f 6e 6f 75 |y or asy|nchronou|
|00004730| 73 6c 79 2e 20 54 68 65 | 20 44 61 74 61 48 50 75 |sly. The| DataHPu|
|00004740| 74 44 61 74 61 20 63 61 | 6c 6c 20 6f 6e 6c 79 20 |tData ca|ll only |
|00004750| 73 75 70 70 6f 72 74 73 | 20 74 68 65 20 73 79 6e |supports| the syn|
|00004760| 63 68 72 6f 6e 6f 75 73 | 20 61 70 70 65 6e 64 69 |chronous| appendi|
|00004770| 6e 67 20 6f 66 20 64 61 | 74 61 20 74 6f 20 61 20 |ng of da|ta to a |
|00004780| 66 69 6c 65 2e 20 54 68 | 65 20 62 75 66 66 65 72 |file. Th|e buffer|
|00004790| 20 6f 66 20 64 61 74 61 | 20 74 6f 20 62 65 20 77 | of data| to be w|
|000047a0| 72 69 74 74 65 6e 20 69 | 73 20 70 61 73 73 65 64 |ritten i|s passed|
|000047b0| 20 69 6e 20 d2 64 61 74 | 61 d3 2e 20 54 68 69 73 | in .dat|a.. This|
|000047c0| 20 62 75 66 66 65 72 20 | 6d 75 73 74 20 62 65 20 | buffer |must be |
|000047d0| 6c 6f 63 6b 65 64 2c 20 | 61 73 20 44 61 74 61 48 |locked, |as DataH|
|000047e0| 57 72 69 74 65 20 6d 61 | 79 20 6d 6f 76 65 20 6d |Write ma|y move m|
|000047f0| 65 6d 6f 72 79 2e 20 54 | 68 65 20 66 69 6c 65 20 |emory. T|he file |
|00004800| 6f 66 66 73 65 74 20 74 | 6f 20 77 72 69 74 65 20 |offset t|o write |
|00004810| 74 6f 20 69 73 20 70 61 | 73 73 65 64 20 69 6e 20 |to is pa|ssed in |
|00004820| d2 6f 66 66 73 65 74 2e | d3 20 54 68 65 20 73 69 |.offset.|. The si|
|00004830| 7a 65 20 6f 66 20 74 68 | 65 20 64 61 74 61 20 62 |ze of th|e data b|
|00004840| 75 66 66 65 72 20 69 73 | 20 70 61 73 73 65 64 20 |uffer is| passed |
|00004850| 69 6e 20 d2 73 69 7a 65 | d3 2e 20 49 66 20 74 68 |in .size|.. If th|
|00004860| 65 20 64 61 74 61 20 69 | 73 20 74 6f 20 62 65 20 |e data i|s to be |
|00004870| 77 72 69 74 74 65 6e 20 | 73 79 6e 63 68 72 6f 6e |written |synchron|
|00004880| 6f 75 73 6c 79 2c 20 73 | 65 74 20 d2 63 6f 6d 70 |ously, s|et .comp|
|00004890| 6c 65 74 69 6f 6e d3 20 | 61 6e 64 20 d2 72 65 66 |letion. |and .ref|
|000048a0| 43 6f 6e d3 20 74 6f 20 | 30 2e 20 49 66 20 74 68 |Con. to |0. If th|
|000048b0| 65 20 64 61 74 61 20 69 | 73 20 74 6f 20 62 65 20 |e data i|s to be |
|000048c0| 77 72 69 74 74 65 6e 20 | 61 73 79 6e 63 68 72 6f |written |asynchro|
|000048d0| 6e 6f 75 73 6c 79 2c 20 | 70 61 73 73 20 61 20 63 |nously, |pass a c|
|000048e0| 6f 6d 70 6c 65 74 69 6f | 6e 20 72 6f 75 74 69 6e |ompletio|n routin|
|000048f0| 65 20 74 6f 20 62 65 20 | 63 61 6c 6c 65 64 20 77 |e to be |called w|
|00004900| 68 65 6e 20 74 68 65 20 | 77 72 69 74 65 20 69 73 |hen the |write is|
|00004910| 20 63 6f 6d 70 6c 65 74 | 65 2e 0d 4d 69 73 63 65 | complet|e..Misce|
|00004920| 6c 6c 61 6e 65 6f 75 73 | 0d 70 61 73 63 61 6c 20 |llaneous|.pascal |
|00004930| 43 6f 6d 70 6f 6e 65 6e | 74 52 65 73 75 6c 74 20 |Componen|tResult |
|00004940| 44 61 74 61 48 47 65 74 | 53 63 68 65 64 75 6c 65 |DataHGet|Schedule|
|00004950| 41 68 65 61 64 54 69 6d | 65 20 28 44 61 74 61 48 |AheadTim|e (DataH|
|00004960| 61 6e 64 6c 65 72 20 64 | 68 2c 20 6c 6f 6e 67 20 |andler d|h, long |
|00004970| 2a 6d 69 6c 6c 69 73 65 | 63 73 29 0d 53 6f 6d 65 |*millise|cs).Some|
|00004980| 20 44 61 74 61 20 48 61 | 6e 64 6c 65 72 73 20 6d | Data Ha|ndlers m|
|00004990| 61 79 20 70 65 72 66 6f | 72 6d 20 6d 6f 72 65 20 |ay perfo|rm more |
|000049a0| 65 66 66 65 63 74 69 76 | 65 6c 79 20 69 66 20 74 |effectiv|ely if t|
|000049b0| 68 65 79 20 61 72 65 20 | 67 69 76 65 6e 20 72 65 |hey are |given re|
|000049c0| 61 64 20 72 65 71 75 65 | 73 74 73 20 69 6e 20 61 |ad reque|sts in a|
|000049d0| 64 76 61 6e 63 65 2e 20 | 43 75 72 72 65 6e 74 6c |dvance. |Currentl|
|000049e0| 79 2c 20 62 79 20 64 65 | 66 61 75 6c 74 2c 20 74 |y, by de|fault, t|
|000049f0| 68 65 20 4d 6f 76 69 65 | 20 54 6f 6f 6c 62 6f 78 |he Movie| Toolbox|
|00004a00| 20 73 63 68 65 64 75 6c | 65 73 20 64 61 74 61 20 | schedul|es data |
|00004a10| 62 65 74 77 65 65 6e 20 | 31 20 61 6e 64 20 32 20 |between |1 and 2 |
|00004a20| 73 65 63 6f 6e 64 73 20 | 61 68 65 61 64 2e 20 48 |seconds |ahead. H|
|00004a30| 6f 77 65 76 65 72 2c 20 | 74 68 69 73 20 6d 61 79 |owever, |this may|
|00004a40| 20 6e 6f 74 20 62 65 20 | 65 6e 6f 75 67 68 20 77 | not be |enough w|
|00004a50| 61 72 6e 69 6e 67 20 66 | 6f 72 20 73 6f 6d 65 20 |arning f|or some |
|00004a60| 73 69 74 75 61 74 69 6f | 6e 73 2e 20 44 61 74 61 |situatio|ns. Data|
|00004a70| 48 53 63 68 65 64 75 6c | 65 41 68 65 61 64 20 72 |HSchedul|eAhead r|
|00004a80| 65 74 75 72 6e 73 20 74 | 68 65 20 70 72 65 66 65 |eturns t|he prefe|
|00004a90| 72 72 65 64 20 73 63 68 | 65 64 75 6c 65 20 61 68 |rred sch|edule ah|
|00004aa0| 65 61 64 20 74 69 6d 65 | 20 66 6f 72 20 74 68 65 |ead time| for the|
|00004ab0| 20 70 61 72 74 69 63 75 | 6c 61 72 20 64 61 74 61 | particu|lar data|
|00004ac0| 20 72 65 66 65 72 65 6e | 63 65 2e 20 43 6c 69 65 | referen|ce. Clie|
|00004ad0| 6e 74 73 20 6d 61 79 20 | 61 74 74 65 6d 70 74 20 |nts may |attempt |
|00004ae0| 74 6f 20 61 63 63 6f 6d | 6d 6f 64 61 74 65 20 74 |to accom|modate t|
|00004af0| 68 65 20 76 61 6c 75 65 | 2c 20 68 6f 77 65 76 65 |he value|, howeve|
|00004b00| 72 20 74 68 65 72 65 20 | 69 73 20 6e 6f 20 67 75 |r there |is no gu|
|00004b10| 61 72 61 6e 74 65 65 20 | 74 68 61 74 20 74 68 65 |arantee |that the|
|00004b20| 20 73 63 68 65 64 75 6c | 65 20 61 68 65 61 64 20 | schedul|e ahead |
|00004b30| 74 69 6d 65 20 77 69 6c | 6c 20 62 65 20 75 73 65 |time wil|l be use|
|00004b40| 64 2e 0d 0d 2e 00 00 00 | 00 02 d7 02 23 00 11 02 |d.......|....#...|
|00004b50| ff 0c 00 ff ff ff ff 00 | 00 00 00 00 00 00 00 02 |........|........|
|00004b60| 23 00 00 02 d7 00 00 00 | 00 00 00 00 0c 00 1e 00 |#.......|........|
|00004b70| 1f 00 01 00 0a 00 00 00 | 00 03 18 02 64 00 2c 00 |........|....d.,.|
|00004b80| 0b 00 10 08 50 61 6c 61 | 74 69 6e 6f 00 00 03 00 |....Pala|tino....|
|00004b90| 10 00 04 01 00 00 0d 00 | 12 00 2e 00 04 00 00 00 |........|........|
|00004ba0| 00 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 00 00 00 |....d..O|NLN.d...|
|00004bb0| 29 00 8b 00 3d 01 9c 00 | 2b a9 57 1b 48 6f 77 20 |)...=...|+.W.How |
|00004bc0| 74 6f 20 57 72 69 74 65 | 20 61 20 44 61 74 61 20 |to Write| a Data |
|00004bd0| 48 61 6e 64 6c 65 72 00 | 0d 00 0e 00 a1 00 64 00 |Handler.|......d.|
|00004be0| 10 4f 4e 4c 4e 00 64 00 | 1c 00 3d 00 cc 00 4d 01 |.ONLN.d.|..=...M.|
|00004bf0| 5c 00 2b 41 11 16 51 75 | 69 63 6b 54 69 6d 65 20 |\.+A..Qu|ickTime |
|00004c00| 76 65 72 73 69 6f 6e 3a | 20 32 2e 30 00 00 0d 00 |version:| 2.0....|
|00004c10| 0c 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 00 33 00 |....d..O|NLN.d.3.|
|00004c20| 5d 00 3c 00 6b 00 83 00 | 28 00 86 00 5a 0c 49 6e |].<.k...|(...Z.In|
|00004c30| 74 72 6f 64 75 63 74 69 | 6f 6e 00 00 04 00 00 00 |troducti|on......|
|00004c40| a1 00 64 00 10 4f 4e 4c | 4e 00 64 00 40 00 7e 00 |..d..ONL|N.d.@.~.|
|00004c50| 3c 00 8c 00 78 00 2a 21 | 0a 47 6f 6f 64 20 6c 75 |<...x.*!|.Good lu|
|00004c60| 63 6b 2e 00 04 01 00 00 | 0d 00 0e 00 a1 00 64 00 |ck......|......d.|
|00004c70| 10 4f 4e 4c 4e 00 64 00 | 4b 00 a8 00 c9 00 b8 01 |.ONLN.d.|K.......|
|00004c80| 5f 00 2b 8d 2c 16 44 61 | 74 61 20 48 61 6e 64 6c |_.+.,.Da|ta Handl|
|00004c90| 65 72 20 53 65 6c 65 63 | 74 69 6f 6e 00 00 04 00 |er Selec|tion....|
|00004ca0| 00 00 0d 00 0c 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |........|d..ONLN.|
|00004cb0| 64 00 62 00 b8 00 3c 00 | c6 01 af 00 28 00 e1 00 |d.b...<.|....(...|
|00004cc0| 5a 42 49 6e 20 74 68 65 | 20 70 61 73 74 2c 20 51 |ZBIn the| past, Q|
|00004cd0| 75 69 63 6b 54 69 6d 65 | 20 63 68 6f 73 65 20 77 |uickTime| chose w|
|00004ce0| 68 69 63 68 20 64 61 74 | 61 20 68 61 6e 64 6c 65 |hich dat|a handle|
|00004cf0| 72 20 74 6f 20 75 73 65 | 20 66 6f 72 20 61 20 67 |r to use| for a g|
|00004d00| 69 76 65 6e 00 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |iven....|d..ONLN.|
|00004d10| 64 00 a5 00 c6 00 3c 00 | d4 01 c7 00 2a 0e 46 4d |d.....<.|....*.FM|
|00004d20| 6f 76 69 65 2f 6d 65 64 | 69 61 20 6f 6e 6c 79 20 |ovie/med|ia only |
|00004d30| 62 61 73 65 64 20 6f 6e | 20 74 68 65 20 74 79 70 |based on| the typ|
|00004d40| 65 20 6f 66 20 74 68 65 | 20 64 61 74 61 20 72 65 |e of the| data re|
|00004d50| 66 65 72 65 6e 63 65 20 | 6f 66 20 74 68 65 20 6d |ference |of the m|
|00004d60| 65 64 69 61 2e 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |edia....|d..ONLN.|
|00004d70| 64 00 ec 00 d4 00 3c 00 | e2 01 18 00 2a 0e 27 4d |d.....<.|....*.'M|
|00004d80| 65 64 69 61 20 77 68 69 | 63 68 20 75 73 65 64 20 |edia whi|ch used |
|00004d90| 66 69 6c 65 73 20 77 65 | 20 61 73 73 69 67 6e 65 |files we| assigne|
|00004da0| 64 20 61 6e 20 d4 00 00 | 2c 00 0a 00 16 07 43 6f |d an ...|,.....Co|
|00004db0| 75 72 69 65 72 00 03 00 | 16 00 a1 00 64 00 10 4f |urier...|....d..O|
|00004dc0| 4e 4c 4e 00 64 01 13 00 | d4 01 18 00 e0 01 3b 00 |NLN.d...|......;.|
|00004dd0| 29 dc 05 61 6c 69 73 d5 | 00 00 03 00 10 00 a1 00 |)..alis.|........|
|00004de0| 64 00 10 4f 4e 4c 4e 00 | 64 01 18 00 d4 01 3b 00 |d..ONLN.|d.....;.|
|00004df0| e2 01 dc 00 29 23 1d 20 | 64 61 74 61 20 72 65 66 |....)#. |data ref|
|00004e00| 65 72 65 6e 63 65 2c 20 | 77 68 69 63 68 20 63 61 |erence, |which ca|
|00004e10| 75 73 65 64 00 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |used....|d..ONLN.|
|00004e20| 64 01 36 00 e2 00 3c 00 | f0 01 d7 00 28 01 0b 00 |d.6...<.|....(...|
|00004e30| 5a 4c 74 68 65 20 73 74 | 61 6e 64 61 72 64 20 41 |ZLthe st|andard A|
|00004e40| 70 70 6c 65 20 44 61 74 | 61 20 48 61 6e 64 6c 65 |pple Dat|a Handle|
|00004e50| 72 20 74 6f 20 62 65 20 | 75 73 65 64 20 74 6f 20 |r to be |used to |
|00004e60| 72 65 61 64 20 74 68 65 | 20 66 69 6c 65 2e 20 49 |read the| file. I|
|00004e70| 66 20 61 6e 6f 74 68 65 | 72 20 64 61 74 61 00 00 |f anothe|r data..|
|00004e80| a1 00 64 00 10 4f 4e 4c | 4e 00 64 01 83 00 f0 00 |..d..ONL|N.d.....|
|00004e90| 3c 00 fe 01 e2 00 2a 0e | 4c 68 61 6e 64 6c 65 72 |<.....*.|Lhandler|
|00004ea0| 20 77 61 73 20 74 6f 20 | 62 65 20 75 73 65 64 2c | was to |be used,|
|00004eb0| 20 65 69 74 68 65 72 20 | 74 68 65 20 6d 6f 76 69 | either |the movi|
|00004ec0| 65 20 68 61 64 20 74 6f | 20 62 65 20 63 68 61 6e |e had to| be chan|
|00004ed0| 67 65 64 20 74 6f 20 63 | 6f 6e 74 61 69 6e 20 61 |ged to c|ontain a|
|00004ee0| 20 64 61 74 61 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 | data...|d..ONLN.|
|00004ef0| 64 01 d0 00 fe 00 3c 01 | 0c 01 cf 00 2a 0e 4b 72 |d.....<.|....*.Kr|
|00004f00| 65 66 65 72 65 6e 63 65 | 20 6f 66 20 61 20 64 69 |eference| of a di|
|00004f10| 66 66 65 72 65 6e 74 20 | 74 79 70 65 20 6f 72 20 |fferent |type or |
|00004f20| 74 68 65 20 6f 74 68 65 | 72 20 64 61 74 61 20 68 |the othe|r data h|
|00004f30| 61 6e 64 6c 65 72 20 68 | 61 64 20 74 6f 20 6f 76 |andler h|ad to ov|
|00004f40| 65 72 72 69 64 65 20 74 | 68 65 00 00 a1 00 64 00 |erride t|he....d.|
|00004f50| 10 4f 4e 4c 4e 00 64 02 | 1c 01 0c 00 3c 01 1a 00 |.ONLN.d.|....<...|
|00004f60| 92 00 2a 0e 10 65 78 69 | 73 74 69 6e 67 20 41 70 |..*..exi|sting Ap|
|00004f70| 70 6c 65 20 d4 00 03 00 | 16 00 a1 00 64 00 10 4f |ple ....|....d..O|
|00004f80| 4e 4c 4e 00 64 02 2c 01 | 0c 00 92 01 18 00 ae 00 |NLN.d.,.|........|
|00004f90| 29 56 04 61 6c 69 73 00 | 03 00 10 00 a1 00 64 00 |)V.alis.|......d.|
|00004fa0| 10 4f 4e 4c 4e 00 64 02 | 30 01 0c 00 ae 01 1a 01 |.ONLN.d.|0.......|
|00004fb0| e0 00 29 1c 37 d5 20 64 | 61 74 61 20 68 61 6e 64 |..).7. d|ata hand|
|00004fc0| 6c 65 72 2c 20 62 75 74 | 20 6f 6e 6c 79 20 66 6f |ler, but| only fo|
|00004fd0| 72 20 74 68 6f 73 65 20 | 76 6f 6c 75 6d 65 73 20 |r those |volumes |
|00004fe0| 77 68 69 63 68 20 69 74 | 20 77 61 73 00 00 a1 00 |which it| was....|
|00004ff0| 64 00 10 4f 4e 4c 4e 00 | 64 02 68 01 1a 00 3c 01 |d..ONLN.|d.h...<.|
|00005000| 28 01 df 00 28 01 43 00 | 5a 4c 63 6f 6e 63 65 72 |(...(.C.|ZLconcer|
|00005010| 6e 65 64 20 77 69 74 68 | 2e 20 54 68 69 73 20 73 |ned with|. This s|
|00005020| 69 74 75 61 74 69 6f 6e | 20 77 61 73 20 66 61 72 |ituation| was far|
|00005030| 20 66 72 6f 6d 20 69 64 | 65 61 6c 2c 20 61 6e 64 | from id|eal, and|
|00005040| 20 70 61 72 74 69 63 75 | 6c 61 72 6c 79 20 6d 65 | particu|larly me|
|00005050| 73 73 79 20 69 6e 00 00 | a1 00 64 00 10 4f 4e 4c |ssy in..|..d..ONL|
|00005060| 4e 00 64 02 b5 01 28 00 | 3c 01 36 01 99 00 2a 0e |N.d...(.|<.6...*.|
|00005070| 3a 61 6e 20 65 6e 76 69 | 72 6f 6e 6d 65 6e 74 20 |:an envi|ronment |
|00005080| 77 68 65 72 65 20 6d 75 | 6c 74 69 70 6c 65 20 64 |where mu|ltiple d|
|00005090| 61 74 61 20 68 61 6e 64 | 6c 65 72 73 20 77 65 72 |ata hand|lers wer|
|000050a0| 65 20 69 6e 76 6f 6c 76 | 65 64 2e 00 a1 00 64 00 |e involv|ed....d.|
|000050b0| 10 4f 4e 4c 4e 00 64 02 | f0 01 44 00 3c 01 52 01 |.ONLN.d.|..D.<.R.|
|000050c0| cc 00 2a 1c 48 51 75 69 | 63 6b 54 69 6d 65 20 6e |..*.HQui|ckTime n|
|000050d0| 6f 77 20 61 6c 6c 6f 77 | 73 20 61 20 64 61 74 61 |ow allow|s a data|
|000050e0| 20 68 61 6e 64 6c 65 72 | 20 74 6f 20 62 65 20 73 | handler| to be s|
|000050f0| 70 65 63 69 66 69 63 61 | 6c 6c 79 20 61 73 73 6f |pecifica|lly asso|
|00005100| 63 69 61 74 65 64 20 77 | 69 74 68 20 61 00 a1 00 |ciated w|ith a...|
|00005110| 64 00 10 4f 4e 4c 4e 00 | 64 03 39 01 52 00 3c 01 |d..ONLN.|d.9.R.<.|
|00005120| 60 01 db 00 2a 0e 4c 70 | 61 72 74 69 63 75 6c 61 |`...*.Lp|articula|
|00005130| 72 20 76 6f 6c 75 6d 65 | 20 28 65 76 65 6e 20 61 |r volume| (even a|
|00005140| 20 70 61 72 74 69 63 75 | 6c 61 72 20 6b 69 6e 64 | particu|lar kind|
|00005150| 20 6f 66 20 66 69 6c 65 | 29 2e 20 54 68 69 73 20 | of file|). This |
|00005160| 61 6c 6c 6f 77 73 20 6d | 6f 76 69 65 73 20 74 6f |allows m|ovies to|
|00005170| 20 62 65 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 03 | be...d.|.ONLN.d.|
|00005180| 86 01 60 00 3c 01 6e 01 | cc 00 2a 0e 46 6d 6f 76 |..`.<.n.|..*.Fmov|
|00005190| 65 64 20 62 65 74 77 65 | 65 6e 20 76 61 72 69 6f |ed betwe|en vario|
|000051a0| 75 73 20 74 79 70 65 73 | 20 6f 66 20 64 65 76 69 |us types| of devi|
|000051b0| 63 65 73 20 77 69 74 68 | 6f 75 74 20 68 61 76 69 |ces with|out havi|
|000051c0| 6e 67 20 74 6f 20 62 65 | 20 61 6c 74 65 72 65 64 |ng to be| altered|
|000051d0| 20 69 6e 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 03 | in...d.|.ONLN.d.|
|000051e0| cd 01 6e 00 3c 01 7c 01 | e2 00 2a 0e 4c 61 6e 79 |..n.<.|.|..*.Lany|
|000051f0| 77 61 79 2c 20 70 72 6f | 76 69 64 65 64 20 74 68 |way, pro|vided th|
|00005200| 61 74 20 74 68 65 20 64 | 65 76 69 63 65 73 20 61 |at the d|evices a|
|00005210| 6c 6c 20 61 70 70 65 61 | 72 20 61 73 20 61 20 76 |ll appea|r as a v|
|00005220| 6f 6c 75 6d 65 2e 20 46 | 75 72 74 68 65 72 6d 6f |olume. F|urthermo|
|00005230| 72 65 2c 20 69 74 20 69 | 73 00 a1 00 64 00 10 4f |re, it i|s...d..O|
|00005240| 4e 4c 4e 00 64 04 1a 01 | 7c 00 3c 01 8a 01 10 00 |NLN.d...||.<.....|
|00005250| 2a 0e 28 6e 6f 74 20 6e | 65 63 65 73 73 61 72 79 |*.(not n|ecessary|
|00005260| 20 74 6f 20 6f 76 65 72 | 72 69 64 65 20 74 68 65 | to over|ride the|
|00005270| 20 65 78 69 73 74 69 6e | 67 20 d4 00 03 00 16 00 | existin|g ......|
|00005280| a1 00 64 00 10 4f 4e 4c | 4e 00 64 04 42 01 7c 01 |..d..ONL|N.d.B.|.|
|00005290| 10 01 88 01 2c 00 29 d4 | 04 61 6c 69 73 00 03 00 |....,.).|.alis...|
|000052a0| 10 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 04 46 01 |....d..O|NLN.d.F.|
|000052b0| 7c 01 2c 01 8a 01 cf 00 | 29 1c 1f d5 20 64 61 74 ||.,.....|)... dat|
|000052c0| 61 20 68 61 6e 64 6c 65 | 72 20 74 6f 20 61 63 68 |a handle|r to ach|
|000052d0| 69 65 76 65 20 74 68 69 | 73 2e 00 00 a1 00 64 00 |ieve thi|s.....d.|
|000052e0| 10 4f 4e 4c 4e 00 64 04 | 66 01 98 00 3c 01 a6 01 |.ONLN.d.|f...<...|
|000052f0| df 00 28 01 c1 00 5a 4a | 54 6f 20 61 63 68 69 65 |..(...ZJ|To achie|
|00005300| 76 65 20 74 68 69 73 2c | 20 74 68 65 20 64 61 74 |ve this,| the dat|
|00005310| 61 20 68 61 6e 64 6c 65 | 72 20 6d 75 73 74 20 69 |a handle|r must i|
|00005320| 6d 70 6c 65 6d 65 6e 74 | 20 74 77 6f 20 61 64 64 |mplement| two add|
|00005330| 69 74 69 6f 6e 61 6c 20 | 63 61 6c 6c 73 2e 20 54 |itional |calls. T|
|00005340| 68 65 00 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 04 |he....d.|.ONLN.d.|
|00005350| b1 01 a6 00 3c 01 b4 01 | 8b 00 2a 0e 3f 66 69 72 |....<...|..*.?fir|
|00005360| 73 74 20 63 61 6c 6c 20 | 6d 75 73 74 20 62 65 20 |st call |must be |
|00005370| 69 6d 70 6c 65 6d 65 6e | 74 65 64 20 62 79 20 61 |implemen|ted by a|
|00005380| 6c 6c 20 64 61 74 61 20 | 68 61 6e 64 6c 65 72 73 |ll data |handlers|
|00005390| 2c 20 6e 6f 74 20 6a 75 | 73 74 20 d4 00 00 03 00 |, not ju|st .....|
|000053a0| 16 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 04 f0 01 |....d..O|NLN.d...|
|000053b0| a6 01 8b 01 b2 01 ae 00 | 28 01 cf 01 a9 05 61 6c |........|(.....al|
|000053c0| 69 73 d5 00 03 00 10 00 | a1 00 64 00 10 4f 4e 4c |is......|..d..ONL|
|000053d0| 4e 00 64 04 f5 01 a6 01 | ae 01 b4 01 c8 00 29 23 |N.d.....|......)#|
|000053e0| 05 20 64 61 74 61 00 00 | a1 00 64 00 10 4f 4e 4c |. data..|..d..ONL|
|000053f0| 4e 00 64 04 fb 01 b4 00 | 3c 01 c2 00 70 00 28 01 |N.d.....|<...p.(.|
|00005400| dd 00 5a 09 68 61 6e 64 | 6c 65 72 73 2e 00 03 00 |..Z.hand|lers....|
|00005410| 16 00 0d 00 0a 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |........|d..ONLN.|
|00005420| 64 05 05 01 cd 00 60 01 | d9 01 e6 00 2b 24 18 41 |d.....`.|....+$.A|
|00005430| 70 61 73 63 61 6c 20 43 | 6f 6d 70 6f 6e 65 6e 74 |pascal C|omponent|
|00005440| 52 65 73 75 6c 74 20 44 | 61 74 61 48 43 61 6e 55 |Result D|ataHCanU|
|00005450| 73 65 44 61 74 61 52 65 | 66 20 28 44 61 74 61 48 |seDataRe|f (DataH|
|00005460| 61 6e 64 6c 65 72 20 64 | 68 2c 20 48 61 6e 64 6c |andler d|h, Handl|
|00005470| 65 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 05 47 01 |e...d..O|NLN.d.G.|
|00005480| d8 00 84 01 e4 01 14 00 | 2b 24 0b 18 64 61 74 61 |........|+$..data|
|00005490| 52 65 66 2c 20 6c 6f 6e | 67 20 2a 75 73 65 46 6c |Ref, lon|g *useFl|
|000054a0| 61 67 73 29 00 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |ags)....|d..ONLN.|
|000054b0| 64 05 60 01 ee 00 60 01 | fa 00 84 00 28 02 16 00 |d.`...`.|....(...|
|000054c0| 7e 06 65 6e 75 6d 20 7b | 00 00 a1 00 64 00 10 4f |~.enum {|....d..O|
|000054d0| 4e 4c 4e 00 64 05 68 01 | f9 00 84 02 05 01 08 00 |NLN.d.h.|........|
|000054e0| 2b 24 0b 16 6b 44 61 74 | 61 48 43 61 6e 52 65 61 |+$..kDat|aHCanRea|
|000054f0| 64 20 3d 20 31 4c 3c 3c | 30 2c 00 00 a1 00 64 00 |d = 1L<<|0,....d.|
|00005500| 10 4f 4e 4c 4e 00 64 05 | 80 02 04 00 84 02 10 01 |.ONLN.d.|........|
|00005510| 20 00 2a 0b 1a 6b 44 61 | 74 61 48 53 70 65 63 69 | .*..kDa|taHSpeci|
|00005520| 61 6c 52 65 61 64 20 3d | 20 31 4c 3c 3c 31 2c 00 |alRead =| 1L<<1,.|
|00005530| a1 00 64 00 10 4f 4e 4c | 4e 00 64 05 9c 02 0f 00 |..d..ONL|N.d.....|
|00005540| 84 02 1b 01 38 00 2a 0b | 1e 6b 44 61 74 61 48 53 |....8.*.|.kDataHS|
|00005550| 70 65 63 69 61 6c 52 65 | 61 64 46 69 6c 65 20 3d |pecialRe|adFile =|
|00005560| 20 31 4c 3c 3c 32 2c 00 | a1 00 64 00 10 4f 4e 4c | 1L<<2,.|..d..ONL|
|00005570| 4e 00 64 05 bc 02 1a 00 | 84 02 26 01 0e 00 2a 0b |N.d.....|..&...*.|
|00005580| 17 6b 44 61 74 61 48 43 | 61 6e 57 72 69 74 65 20 |.kDataHC|anWrite |
|00005590| 3d 20 31 4c 3c 3c 33 2c | 00 00 a1 00 64 00 10 4f |= 1L<<3,|....d..O|
|000055a0| 4e 4c 4e 00 64 05 d5 02 | 25 00 84 02 31 01 20 00 |NLN.d...|%...1. .|
|000055b0| 2a 0b 1a 6b 44 61 74 61 | 48 53 70 65 63 69 61 6c |*..kData|HSpecial|
|000055c0| 57 72 69 74 65 20 3d 20 | 31 3c 3c 34 2c 00 a1 00 |Write = |1<<4,...|
|000055d0| 64 00 10 4f 4e 4c 4e 00 | 64 05 f1 02 30 00 84 02 |d..ONLN.|d...0...|
|000055e0| 3c 01 38 00 2a 0b 1e 6b | 44 61 74 61 48 53 70 65 |<.8.*..k|DataHSpe|
|000055f0| 63 69 61 6c 57 72 69 74 | 65 46 69 6c 65 20 3d 20 |cialWrit|eFile = |
|00005600| 31 3c 3c 35 2c 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |1<<5,...|d..ONLN.|
|00005610| 64 06 11 02 3b 00 84 02 | 47 01 3e 00 2a 0b 1f 6b |d...;...|G.>.*..k|
|00005620| 44 61 74 61 48 43 61 6e | 53 74 72 65 61 6d 69 6e |DataHCan|Streamin|
|00005630| 67 57 72 69 74 65 20 3d | 20 31 3c 3c 36 2c 00 00 |gWrite =| 1<<6,..|
|00005640| a1 00 64 00 10 4f 4e 4c | 4e 00 64 06 32 02 46 00 |..d..ONL|N.d.2.F.|
|00005650| 84 02 52 01 32 00 2a 0b | 1d 6b 44 61 74 61 48 4d |..R.2.*.|.kDataHM|
|00005660| 75 73 74 43 68 65 63 6b | 44 61 74 61 52 65 66 20 |ustCheck|DataRef |
|00005670| 3d 20 31 3c 3c 37 00 00 | a1 00 64 00 10 4f 4e 4c |= 1<<7..|..d..ONL|
|00005680| 4e 00 64 06 50 02 51 00 | 60 02 5d 00 6c 00 28 02 |N.d.P.Q.|`.].l.(.|
|00005690| 79 00 7e 02 7d 3b 00 00 | 0d 00 0c 00 a1 00 64 00 |y.~.};..|......d.|
|000056a0| 10 4f 4e 4c 4e 00 64 06 | 53 02 67 00 3c 02 73 00 |.ONLN.d.|S.g.<.s.|
|000056b0| ba 00 28 02 90 00 5a 12 | 44 61 74 61 48 43 61 6e |..(...Z.|DataHCan|
|000056c0| 55 73 65 44 61 74 61 52 | 65 66 00 00 03 00 10 00 |UseDataR|ef......|
|000056d0| a1 00 64 00 10 4f 4e 4c | 4e 00 64 06 65 02 67 00 |..d..ONL|N.d.e.g.|
|000056e0| ba 02 75 01 e4 00 29 7e | 39 20 20 69 73 20 70 61 |..u...)~|9  is pa|
|000056f0| 73 73 65 64 20 61 20 64 | 61 74 61 20 72 65 66 65 |ssed a d|ata refe|
|00005700| 72 65 6e 63 65 20 61 6e | 64 20 72 65 74 75 72 6e |rence an|d return|
|00005710| 73 20 66 6c 61 67 73 20 | 69 6e 64 69 63 61 74 69 |s flags |indicati|
|00005720| 6e 67 00 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 06 |ng....d.|.ONLN.d.|
|00005730| 9f 02 75 00 3c 02 83 01 | e7 00 28 02 9e 00 5a 54 |..u.<...|..(...ZT|
|00005740| 69 74 73 20 61 62 69 6c | 69 74 79 20 74 6f 20 61 |its abil|ity to a|
|00005750| 63 63 65 73 73 20 74 68 | 65 20 64 61 74 61 20 72 |ccess th|e data r|
|00005760| 65 66 65 72 65 6e 63 65 | 2e 20 49 66 20 74 68 65 |eference|. If the|
|00005770| 20 64 61 74 61 20 72 65 | 66 65 72 65 6e 63 65 20 | data re|ference |
|00005780| 63 61 6e 6e 6f 74 20 62 | 65 20 72 65 61 64 20 74 |cannot b|e read t|
|00005790| 6f 20 6f 72 00 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |o or....|d..ONLN.|
|000057a0| 64 06 f4 02 83 00 3c 02 | 91 01 51 00 2a 0e 34 77 |d.....<.|..Q.*.4w|
|000057b0| 72 69 74 74 65 6e 20 66 | 72 6f 6d 2c 20 74 68 65 |ritten f|rom, the|
|000057c0| 20 72 65 74 75 72 6e 65 | 64 20 66 6c 61 67 73 20 | returne|d flags |
|000057d0| 73 68 6f 75 6c 64 20 62 | 65 20 73 65 74 20 74 6f |should b|e set to|
|000057e0| 20 30 2e 00 03 00 16 00 | a1 00 64 00 10 4f 4e 4c | 0......|..d..ONL|
|000057f0| 4e 00 64 07 29 02 9f 00 | 3c 02 ab 00 97 00 2a 1c |N.d.)...|<.....*.|
|00005800| 0d 6b 44 61 74 61 48 43 | 61 6e 52 65 61 64 00 00 |.kDataHC|anRead..|
|00005810| 03 00 10 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 07 |......d.|.ONLN.d.|
|00005820| 37 02 9f 00 d3 02 ad 01 | 88 00 29 97 21 63 61 6e |7.......|..).!can|
|00005830| 20 72 65 61 64 20 66 72 | 6f 6d 20 74 68 69 73 20 | read fr|om this |
|00005840| 64 61 74 61 20 72 65 66 | 65 72 65 6e 63 65 00 00 |data ref|erence..|
|00005850| 2b 03 28 15 41 70 70 6c | 65 20 43 6f 6e 66 69 64 |+.(.Appl|e Confid|
|00005860| 65 6e 74 69 61 6c 20 2d | 20 00 29 75 01 31 00 00 |ential -| .)u.1..|
|00005870| ff 12 c8 00 00 00 00 02 | d7 02 23 00 11 02 ff 0c |........|..#.....|
|00005880| 00 ff ff ff ff 00 00 00 | 00 00 00 00 00 02 23 00 |........|......#.|
|00005890| 00 02 d7 00 00 00 00 00 | 00 00 0c 00 1e 00 1f 00 |........|........|
|000058a0| 01 00 0a 00 00 00 00 03 | 18 02 64 00 2c 00 0a 00 |........|..d.,...|
|000058b0| 16 07 43 6f 75 72 69 65 | 72 00 03 00 16 00 0d 00 |..Courie|r.......|
|000058c0| 0c 00 2e 00 04 00 00 00 | 00 00 a1 00 64 00 10 4f |........|....d..O|
|000058d0| 4e 4c 4e 00 64 00 00 00 | 29 00 3c 00 35 00 b3 00 |NLN.d...|).<.5...|
|000058e0| 2b 5a 52 11 6b 44 61 74 | 61 48 53 70 65 63 69 61 |+ZR.kDat|aHSpecia|
|000058f0| 6c 52 65 61 64 00 2c 00 | 0b 00 10 08 50 61 6c 61 |lRead.,.|....Pala|
|00005900| 74 69 6e 6f 00 00 03 00 | 10 00 a1 00 64 00 10 4f |tino....|....d..O|
|00005910| 4e 4c 4e 00 64 00 12 00 | 29 00 d3 00 37 01 b3 00 |NLN.d...|)...7...|
|00005920| 29 97 29 63 61 6e 20 72 | 65 61 64 20 66 72 6f 6d |).)can r|ead from|
|00005930| 20 74 68 69 73 20 64 61 | 74 61 20 72 65 66 65 72 | this da|ta refer|
|00005940| 65 6e 63 65 20 75 73 69 | 6e 67 20 61 00 00 a1 00 |ence usi|ng a....|
|00005950| 64 00 10 4f 4e 4c 4e 00 | 64 00 3c 00 37 00 d3 00 |d..ONLN.|d.<.7...|
|00005960| 45 01 c1 00 2a 0e 2a 73 | 70 65 63 69 61 6c 69 7a |E...*.*s|pecializ|
|00005970| 65 64 20 6d 65 74 68 6f | 64 20 28 66 6f 72 20 65 |ed metho|d (for e|
|00005980| 78 61 6d 70 6c 65 2c 20 | 69 66 20 61 6e 20 48 46 |xample, |if an HF|
|00005990| 53 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 00 67 00 |S...d..O|NLN.d.g.|
|000059a0| 45 00 d3 00 53 01 d0 00 | 2a 0e 2a 76 6f 6c 75 6d |E...S...|*.*volum|
|000059b0| 65 2c 20 74 68 69 73 20 | 77 6f 75 6c 64 20 6d 65 |e, this |would me|
|000059c0| 61 6e 20 72 65 61 64 69 | 6e 67 20 6f 74 68 65 72 |an readi|ng other|
|000059d0| 20 74 68 61 6e 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 | than...|d..ONLN.|
|000059e0| 64 00 92 00 53 00 d3 00 | 61 01 54 00 2a 0e 18 75 |d...S...|a.T.*..u|
|000059f0| 73 69 6e 67 20 46 69 6c | 65 20 53 79 73 74 65 6d |sing Fil|e System|
|00005a00| 20 63 61 6c 6c 73 29 00 | 03 00 16 00 a1 00 64 00 | calls).|......d.|
|00005a10| 10 4f 4e 4c 4e 00 64 00 | ac 00 61 00 3c 00 6d 00 |.ONLN.d.|..a.<.m.|
|00005a20| c8 00 28 00 8a 00 5a 14 | 6b 44 61 74 61 48 53 70 |..(...Z.|kDataHSp|
|00005a30| 65 63 69 61 6c 52 65 61 | 64 46 69 6c 00 00 a1 00 |ecialRea|dFil....|
|00005a40| 64 00 10 4f 4e 4c 4e 00 | 64 00 c0 00 6d 00 3c 00 |d..ONLN.|d...m.<.|
|00005a50| 79 00 43 00 2a 0c 01 65 | 00 00 03 00 10 00 a1 00 |y.C.*..e|........|
|00005a60| 64 00 10 4f 4e 4c 4e 00 | 64 00 c2 00 61 00 d3 00 |d..ONLN.|d...a...|
|00005a70| 6f 01 b3 00 28 00 8a 00 | f1 29 63 61 6e 20 72 65 |o...(...|.)can re|
|00005a80| 61 64 20 66 72 6f 6d 20 | 74 68 69 73 20 64 61 74 |ad from |this dat|
|00005a90| 61 20 72 65 66 65 72 65 | 6e 63 65 20 75 73 69 6e |a refere|nce usin|
|00005aa0| 67 20 61 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 00 |g a...d.|.ONLN.d.|
|00005ab0| ec 00 6f 00 d3 00 7d 01 | e6 00 2a 0e 33 73 70 65 |..o...}.|..*.3spe|
|00005ac0| 63 69 61 6c 69 7a 65 64 | 20 6d 65 74 68 6f 64 20 |cialized| method |
|00005ad0| 77 68 69 63 68 20 69 73 | 20 73 70 65 63 69 66 69 |which is| specifi|
|00005ae0| 63 20 74 6f 20 74 68 65 | 20 74 79 70 65 20 6f 66 |c to the| type of|
|00005af0| 00 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 01 20 00 |....d..O|NLN.d. .|
|00005b00| 7d 00 d3 00 8b 01 d0 00 | 2a 0e 2e 66 69 6c 65 20 |}.......|*..file |
|00005b10| 62 65 69 6e 67 20 72 65 | 61 64 20 28 66 6f 72 20 |being re|ad (for |
|00005b20| 65 78 61 6d 70 6c 65 20 | 61 20 48 79 70 65 72 43 |example |a HyperC|
|00005b30| 61 72 64 20 73 74 61 63 | 6b 00 a1 00 64 00 10 4f |ard stac|k...d..O|
|00005b40| 4e 4c 4e 00 64 01 4f 00 | 8b 00 d3 00 99 01 e2 00 |NLN.d.O.|........|
|00005b50| 2a 0e 30 6d 69 67 68 74 | 20 62 65 20 6d 6f 72 65 |*.0might| be more|
|00005b60| 20 65 66 66 69 63 69 65 | 6e 74 6c 79 20 72 65 61 | efficie|ntly rea|
|00005b70| 64 20 62 79 20 61 20 6d | 65 74 68 6f 64 20 6f 74 |d by a m|ethod ot|
|00005b80| 68 65 72 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 01 |her...d.|.ONLN.d.|
|00005b90| 80 00 99 00 d3 00 a7 01 | cb 00 2a 0e 2c 74 68 61 |........|..*.,tha|
|00005ba0| 6e 20 74 68 61 74 20 75 | 73 65 64 20 62 79 20 74 |n that u|sed by t|
|00005bb0| 68 65 20 73 74 61 6e 64 | 61 72 64 20 44 61 74 61 |he stand|ard Data|
|00005bc0| 20 48 61 6e 64 6c 65 72 | 29 00 03 00 16 00 a1 00 | Handler|).......|
|00005bd0| 64 00 10 4f 4e 4c 4e 00 | 64 01 ae 00 a7 00 3c 00 |d..ONLN.|d.....<.|
|00005be0| b3 00 9e 00 28 00 d0 00 | 5a 0e 6b 44 61 74 61 48 |....(...|Z.kDataH|
|00005bf0| 43 61 6e 57 72 69 74 65 | 00 00 03 00 10 00 a1 00 |CanWrite|........|
|00005c00| 64 00 10 4f 4e 4c 4e 00 | 64 01 bd 00 a7 00 d3 00 |d..ONLN.|d.......|
|00005c10| b5 01 7c 00 29 97 20 63 | 61 6e 20 77 72 69 74 65 |..|.). c|an write|
|00005c20| 20 74 6f 20 74 68 69 73 | 20 64 61 74 61 20 72 65 | to this| data re|
|00005c30| 66 65 72 65 6e 63 65 00 | 03 00 16 00 a1 00 64 00 |ference.|......d.|
|00005c40| 10 4f 4e 4c 4e 00 64 01 | df 00 b5 00 3c 00 c1 00 |.ONLN.d.|....<...|
|00005c50| ba 00 28 00 de 00 5a 12 | 6b 44 61 74 61 48 53 70 |..(...Z.|kDataHSp|
|00005c60| 65 63 69 61 6c 57 72 69 | 74 65 00 00 03 00 10 00 |ecialWri|te......|
|00005c70| a1 00 64 00 10 4f 4e 4c | 4e 00 64 01 f2 00 b5 00 |..d..ONL|N.d.....|
|00005c80| d3 00 c3 01 e6 00 29 97 | 34 63 61 6e 20 77 72 69 |......).|4can wri|
|00005c90| 74 65 20 74 6f 20 74 68 | 69 73 20 64 61 74 61 20 |te to th|is data |
|00005ca0| 72 65 66 65 72 65 6e 63 | 65 20 75 73 69 6e 67 20 |referenc|e using |
|00005cb0| 61 20 73 70 65 63 69 61 | 6c 69 7a 65 64 00 a1 00 |a specia|lized...|
|00005cc0| 64 00 10 4f 4e 4c 4e 00 | 64 02 27 00 c3 00 d3 00 |d..ONLN.|d.'.....|
|00005cd0| d1 01 c5 00 2a 0e 2a 6d | 65 74 68 6f 64 20 28 66 |....*.*m|ethod (f|
|00005ce0| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 20 61 20 73 70 |or examp|le, a sp|
|00005cf0| 65 63 69 61 6c 69 7a 65 | 64 20 6e 65 74 77 6f 72 |ecialize|d networ|
|00005d00| 6b 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 02 52 00 |k...d..O|NLN.d.R.|
|00005d10| d1 00 d3 00 df 01 05 00 | 2a 0e 09 70 72 6f 74 6f |........|*..proto|
|00005d20| 63 6f 6c 29 00 00 03 00 | 16 00 a1 00 64 00 10 4f |col)....|....d..O|
|00005d30| 4e 4c 4e 00 64 02 5d 00 | df 00 3c 00 eb 00 c8 00 |NLN.d.].|..<.....|
|00005d40| 28 01 08 00 5a 14 6b 44 | 61 74 61 48 53 70 65 63 |(...Z.kD|ataHSpec|
|00005d50| 69 61 6c 57 72 69 74 65 | 46 69 00 00 a1 00 64 00 |ialWrite|Fi....d.|
|00005d60| 10 4f 4e 4c 4e 00 64 02 | 71 00 eb 00 3c 00 f7 00 |.ONLN.d.|q...<...|
|00005d70| 4a 00 2a 0c 02 6c 65 00 | 03 00 10 00 a1 00 64 00 |J.*..le.|......d.|
|00005d80| 10 4f 4e 4c 4e 00 64 02 | 75 00 df 00 d3 00 ed 01 |.ONLN.d.|u.......|
|00005d90| 87 00 28 01 08 00 f1 1f | 28 74 68 69 73 20 68 61 |..(.....|(this ha|
|00005da0| 73 20 6e 6f 20 6d 65 61 | 6e 69 6e 67 20 72 69 67 |s no mea|ning rig|
|00005db0| 68 74 20 6e 6f 77 29 00 | 03 00 16 00 a1 00 64 00 |ht now).|......d.|
|00005dc0| 10 4f 4e 4c 4e 00 64 02 | 96 00 f7 00 3c 01 03 00 |.ONLN.d.|....<...|
|00005dd0| c8 00 28 01 20 00 5a 14 | 6b 44 61 74 61 48 43 61 |..(. .Z.|kDataHCa|
|00005de0| 6e 53 74 72 65 61 6d 69 | 6e 67 57 72 00 00 a1 00 |nStreami|ngWr....|
|00005df0| 64 00 10 4f 4e 4c 4e 00 | 64 02 aa 01 03 00 3c 01 |d..ONLN.|d.....<.|
|00005e00| 0f 00 51 00 2a 0c 03 69 | 74 65 00 00 03 00 10 00 |..Q.*..i|te......|
|00005e10| a1 00 64 00 10 4f 4e 4c | 4e 00 64 02 ae 00 f7 00 |..d..ONL|N.d.....|
|00005e20| d3 01 05 01 d8 00 28 01 | 20 00 f1 2b 73 75 70 70 |......(.| ..+supp|
|00005e30| 6f 72 74 73 20 74 68 65 | 20 41 50 49 20 63 6f 6d |orts the| API com|
|00005e40| 6d 61 6e 64 73 20 66 6f | 72 20 6d 6f 76 69 65 20 |mands fo|r movie |
|00005e50| 63 61 70 74 75 72 65 00 | 03 00 16 00 a1 00 64 00 |capture.|......d.|
|00005e60| 10 4f 4e 4c 4e 00 64 02 | db 01 0f 00 3c 01 1b 00 |.ONLN.d.|....<...|
|00005e70| c8 00 28 01 38 00 5a 14 | 6b 44 61 74 61 48 4d 75 |..(.8.Z.|kDataHMu|
|00005e80| 73 74 43 68 65 63 6b 44 | 61 74 61 52 00 00 a1 00 |stCheckD|ataR....|
|00005e90| 64 00 10 4f 4e 4c 4e 00 | 64 02 ef 01 1b 00 3c 01 |d..ONLN.|d.....<.|
|00005ea0| 27 00 4a 00 2a 0c 02 65 | 66 00 03 00 10 00 a1 00 |'.J.*..e|f.......|
|00005eb0| 64 00 10 4f 4e 4c 4e 00 | 64 02 f3 01 0f 00 d3 01 |d..ONLN.|d.......|
|00005ec0| 1d 01 70 00 28 01 38 00 | f1 1f 28 74 68 69 73 20 |..p.(.8.|..(this |
|00005ed0| 66 6c 61 67 20 69 73 20 | 6f 6e 6c 79 20 75 73 65 |flag is |only use|
|00005ee0| 64 20 66 6f 72 20 74 68 | 65 00 a1 00 64 00 10 4f |d for th|e...d..O|
|00005ef0| 4e 4c 4e 00 64 03 13 01 | 1d 00 d3 01 2b 01 69 00 |NLN.d...|....+.i.|
|00005f00| 2a 0e 18 44 61 74 61 48 | 47 65 74 56 6f 6c 75 6d |*..DataH|GetVolum|
|00005f10| 65 49 6e 66 6f 20 63 61 | 6c 6c 29 00 a1 00 64 00 |eInfo ca|ll)...d.|
|00005f20| 10 4f 4e 4c 4e 00 64 03 | 2e 01 39 00 3c 01 47 00 |.ONLN.d.|..9.<.G.|
|00005f30| b0 00 28 01 62 00 5a 14 | 54 68 65 20 73 74 61 6e |..(.b.Z.|The stan|
|00005f40| 64 61 72 64 20 41 70 70 | 6c 65 20 d4 00 00 03 00 |dard App|le .....|
|00005f50| 16 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 03 42 01 |....d..O|NLN.d.B.|
|00005f60| 39 00 b0 01 45 00 cc 00 | 29 74 04 61 6c 69 73 00 |9...E...|)t.alis.|
|00005f70| 03 00 10 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 03 |......d.|.ONLN.d.|
|00005f80| 46 01 39 00 cc 01 47 01 | 4b 00 29 1c 17 d5 20 44 |F.9...G.|K.)... D|
|00005f90| 61 74 61 20 48 61 6e 64 | 6c 65 72 20 72 65 74 75 |ata Hand|ler retu|
|00005fa0| 72 6e 73 20 00 00 03 00 | 16 00 a1 00 64 00 10 4f |rns ....|....d..O|
|00005fb0| 4e 4c 4e 00 64 03 5d 01 | 39 01 4b 01 45 01 a6 00 |NLN.d.].|9.K.E...|
|00005fc0| 29 7f 0d 6b 44 61 74 61 | 48 43 61 6e 52 65 61 64 |)..kData|HCanRead|
|00005fd0| 00 00 03 00 10 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |........|d..ONLN.|
|00005fe0| 64 03 6a 01 39 01 a6 01 | 47 01 be 00 29 5b 04 20 |d.j.9...|G...)[. |
|00005ff0| 61 6e 64 00 03 00 16 00 | a1 00 64 00 10 4f 4e 4c |and.....|..d..ONL|
|00006000| 4e 00 64 03 6f 01 47 00 | 3c 01 53 00 9e 00 28 01 |N.d.o.G.|<.S...(.|
|00006010| 70 00 5a 0e 6b 44 61 74 | 61 48 43 61 6e 57 72 69 |p.Z.kDat|aHCanWri|
|00006020| 74 65 00 00 03 00 10 00 | a1 00 64 00 10 4f 4e 4c |te......|..d..ONL|
|00006030| 4e 00 64 03 7d 01 47 00 | 9e 01 55 01 db 00 29 62 |N.d.}.G.|..U...)b|
|00006040| 3f 20 66 6f 72 20 61 6e | 79 20 64 61 74 61 20 72 |? for an|y data r|
|00006050| 65 66 65 72 65 6e 63 65 | 20 70 61 73 73 65 64 20 |eference| passed |
|00006060| 74 6f 20 69 74 2e 20 54 | 68 69 73 20 69 6e 64 69 |to it. T|his indi|
|00006070| 63 61 74 65 73 20 74 68 | 61 74 20 69 74 20 69 73 |cates th|at it is|
|00006080| 00 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 03 bd 01 |....d..O|NLN.d...|
|00006090| 55 00 3c 01 63 01 d3 00 | 28 01 7e 00 5a 47 61 62 |U.<.c...|(.~.ZGab|
|000060a0| 6c 65 20 74 6f 20 73 75 | 70 70 6f 72 74 20 72 65 |le to su|pport re|
|000060b0| 61 64 69 6e 67 20 61 6e | 64 20 77 72 69 74 69 6e |ading an|d writin|
|000060c0| 67 20 74 6f 20 61 6e 79 | 20 76 6f 6c 75 6d 65 2e |g to any| volume.|
|000060d0| 20 41 20 64 61 74 61 20 | 68 61 6e 64 6c 65 72 20 | A data |handler |
|000060e0| 77 68 69 63 68 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |which...|d..ONLN.|
|000060f0| 64 04 05 01 63 00 3c 01 | 71 01 ec 00 2a 0e 4e 70 |d...c.<.|q...*.Np|
|00006100| 72 6f 76 69 64 65 64 20 | 73 70 65 63 69 61 6c 69 |rovided |speciali|
|00006110| 7a 65 64 20 61 63 63 65 | 73 73 20 74 6f 20 61 20 |zed acce|ss to a |
|00006120| 70 61 72 74 69 63 75 6c | 61 72 20 76 6f 6c 75 6d |particul|ar volum|
|00006130| 65 20 77 6f 75 6c 64 20 | 72 65 74 75 72 6e 20 30 |e would |return 0|
|00006140| 20 66 6f 72 20 61 6e 79 | 20 64 61 74 61 00 a1 00 | for any| data...|
|00006150| 64 00 10 4f 4e 4c 4e 00 | 64 04 54 01 71 00 3c 01 |d..ONLN.|d.T.q.<.|
|00006160| 7f 01 c2 00 2a 0e 44 72 | 65 66 65 72 65 6e 63 65 |....*.Dr|eference|
|00006170| 20 72 65 66 65 72 65 6e | 63 69 6e 67 20 61 20 76 | referen|cing a v|
|00006180| 6f 6c 75 6d 65 20 77 68 | 69 63 68 20 64 69 64 20 |olume wh|ich did |
|00006190| 6e 6f 74 20 73 75 70 70 | 6f 72 74 73 20 69 74 73 |not supp|orts its|
|000061a0| 20 6e 65 74 77 6f 72 6b | 69 6e 67 00 a1 00 64 00 | network|ing...d.|
|000061b0| 10 4f 4e 4c 4e 00 64 04 | 99 01 7f 00 3c 01 8d 00 |.ONLN.d.|....<...|
|000061c0| c9 00 2a 0e 1a 70 72 6f | 74 6f 63 6f 6c 2e 20 49 |..*..pro|tocol. I|
|000061d0| 74 20 77 6f 75 6c 64 20 | 72 65 74 75 72 6e 20 00 |t would |return .|
|000061e0| 03 00 16 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 04 |......d.|.ONLN.d.|
|000061f0| b3 01 7f 00 c9 01 8b 01 | 24 00 29 8d 0d 6b 44 61 |........|$.)..kDa|
|00006200| 74 61 48 43 61 6e 52 65 | 61 64 00 00 03 00 10 00 |taHCanRe|ad......|
|00006210| a1 00 64 00 10 4f 4e 4c | 4e 00 64 04 c0 01 7f 01 |..d..ONL|N.d.....|
|00006220| 24 01 8d 01 3f 00 29 5b | 05 20 61 6e 64 20 00 00 |$...?.)[|. and ..|
|00006230| 03 00 16 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 04 |......d.|.ONLN.d.|
|00006240| c5 01 7f 01 3f 01 8b 01 | b6 00 29 1b 11 6b 44 61 |....?...|..)..kDa|
|00006250| 74 61 48 53 70 65 63 69 | 61 6c 52 65 61 64 00 00 |taHSpeci|alRead..|
|00006260| 03 00 10 00 a1 00 64 00 | 10 4f 4e 4c 4e 00 64 04 |......d.|.ONLN.d.|
|00006270| d6 01 7f 01 b6 01 8d 01 | e0 00 29 77 08 20 66 6f |........|..)w. fo|
|00006280| 72 20 61 6e 79 00 a1 00 | 64 00 10 4f 4e 4c 4e 00 |r any...|d..ONLN.|
|00006290| 64 04 df 01 8d 00 3c 01 | 9b 01 e6 00 28 01 b6 00 |d.....<.|....(...|
|000062a0| 5a 4c 76 6f 6c 75 6d 65 | 20 77 68 69 63 68 20 64 |ZLvolume| which d|
|000062b0| 69 64 20 73 75 70 70 6f | 72 74 20 69 74 73 20 6e |id suppo|rt its n|
|000062c0| 65 74 77 6f 72 6b 69 6e | 67 20 70 72 6f 74 6f 63 |etworkin|g protoc|
|000062d0| 6f 6c 20 28 69 66 20 69 | 74 20 73 75 70 70 6f 72 |ol (if i|t suppor|
|000062e0| 74 65 64 20 77 72 69 74 | 69 6e 67 20 61 73 00 00 |ted writ|ing as..|
|000062f0| a1 00 64 00 10 4f 4e 4c | 4e 00 64 05 2c 01 9b 00 |..d..ONL|N.d.,...|
|00006300| 3c 01 a9 00 9e 00 2a 0e | 13 77 65 6c 6c 2c 20 69 |<.....*.|.well, i|
|00006310| 74 20 77 6f 75 6c 64 20 | 73 65 74 20 00 00 03 00 |t would |set ....|
|00006320| 16 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 05 3f 01 |....d..O|NLN.d.?.|
|00006330| 9b 00 9e 01 a7 01 00 00 | 29 62 0e 6b 44 61 74 61 |........|)b.kData|
|00006340| 48 43 61 6e 57 72 69 74 | 65 00 03 00 10 00 a1 00 |HCanWrit|e.......|
|00006350| 64 00 10 4f 4e 4c 4e 00 | 64 05 4d 01 9b 01 00 01 |d..ONLN.|d.M.....|
|00006360| a9 01 1b 00 29 62 05 20 | 61 6e 64 20 00 00 03 00 |....)b. |and ....|
|00006370| 16 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 05 52 01 |....d..O|NLN.d.R.|
|00006380| 9b 01 1b 01 a7 01 99 00 | 29 1b 12 6b 44 61 74 61 |........|)..kData|
|00006390| 48 53 70 65 63 69 61 6c | 57 72 69 74 65 00 03 00 |HSpecial|Write...|
|000063a0| 10 00 a1 00 64 00 10 4f | 4e 4c 4e 00 64 05 64 01 |....d..O|NLN.d.d.|
|000063b0| 9b 01 99 01 a9 01 a0 00 | 29 7e 02 29 2e 00 a1 00 |........|)~.)....|
|000063c0| 64 00 10 4f 4e 4c 4e 00 | 64 05 67 01 b7 00 3c 01 |d..ONLN.|d.g...<.|
|000063d0| c5 00 7d 00 28 01 e0 00 | 5a 0b 54 68 65 20 41 70 |..}.(...|Z.The Ap|
|000063e0| 70 6c 65 20 d4 00 03 00 | 16 00 a1 00 64 00 10 4f |ple ....|....d..O|
|000063f0| 4e 4c 4e 00 64 05 72 01 | b7 00 7d 01 c3 00 99 00 |NLN.d.r.|..}.....|
+--------+-------------------------+-------------------------+--------+--------+
Only 25.0 KB of data is shown above.